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PREFACE 


This manual describes the PDP-11 MACRO-XI Assembler (MACXI) and 
Assembly^ Language and discusses briefly how to program the PDP-11 
computer* It is recommended that the reader have with him copies of 
the PDP-11 Processor Handbook and* optionally* the PDP-11 Peripherals 
and Interfacing Handbook * References are made to these documents 
throughout this manual (although this document is complete * the 
additional material provides further details). The user is also 
advised to obtain a PDP-11 pocket Instruction List card for easy 
reference® (These items can be obtained from the Digital Software 
Distribution Center®) 

This MACRO-11 Assembler operates under the PDP-15 DOS (Disk Operating 
System) Monitor in conjunction with PXREX* a multiprogramming 
executive running on a PDP-11 in the Unichannel 15 system® 

Some notable features of MACH arei 

X® Device and filename specifications for input 

2® Error listing on command output device 

3® Alphabetized , formatted symbol table listing 

4® Conditional assembly directives 

5® User defined macros 

6® Extensive listing control 


Associated Documents z 


PDP-11/20 Processor Handbook 1X2*01071*1855 

PDP-11 Peripherals and Interfacing Handbook 112*01071*1854 

DOS-15 Users Manual* DEC-15-ODUMA-A-D 

EDIT Utility Program* DEC-15-YWZB-DN6 

PIP DOS Monitor Utility Program* DEC-15-UPXPA-B-D 

The MACH assembler* a subset of the standard MACRO-11 assembler for 
the PDP-11* is specifically written for the Unichannel-15 system® 
Programs written for the MACRO-11 assembler will not necessarily 
assemble correctly with MACX1* and programs written for MACH will not 
necessarily assemble correctly with MACRO-11® 

The MACH assembler generates only absolute binary output® 
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CHAPTER 1 


FUNDAMENTALS OF PROGRAMMING THE PDP-11 


This Chapter presents some fundamental software concepts essential to 
efficient assembly language programming of the PDP-11 computer© A 
description of the hardware components of the PDP-11 family can be 
found in the two DEC paperback handbookst 

PDP-11 Processor Handbook (11/20 or 11/45 edition) 

PDP-11 Peripherals and Interfacing Handbook 

No attempt is made in this document to describe the PDP-11 hardware or 
the function of the various PDP-11 instructions e However^ it is 
recommended that the reader become familiar with this material before 
proceeding® 

The new PDP-11 programmer is advised to read this Chapter before 
reading further in this manual® The concepts in this Chapter will 
create a conceptual matrix within which explanations of the language 
fit® since the techniques described herein work best with the PDP-11 
and are used in PDP-11 system programs f they should be considered from 
the very start of your PDP-11 programming experience© 


1®1 MODULAR PROGRAMMING 

The PDP-11 family of computers lend themselves most easily to a 
modular system of programming® In such a system the programmer must 
envision the entire program and break it down into constituent 
subroutines® Modular development forces an awareness of the final 
system® Ideally^ this should cause all components of the system to be 
considered from the very beginning of the development effort rather 
than patched into a partially-developed system© This provides for the 
best use of the PDP-11 hardware (as discussed later in this Chapter) f 
and results in programs which are more easily modified than those 
coded with straight-line coding techniques® 

To this end ? flowcharting of the entire system is best performed prior 
to coding rather than during or after the coding effort© The 
programmer is then able to work on small portions of the program at a 
time© Subroutines of approximately one or two pages are considered 
desirable© 



Modular programming practices maximize the usefulness of an 
installation^ resources• Programmed modules can be used in other 
programs or systems having similar or identical functions without the 
expense of redundant development© Also software modules developed as 
functional entities are more likely to be free of serious logical 
errors as a result of the original programming effort© The use of 
such modules will simplify the development of later systems by 
incorporating proven pieces© 

Modular development provides for ease of use and modification rather 
than simplifying the original development© While care must be taken 
in the beginning to ensure correct modular system development § the 
benefits of standardization to the generation of maintenance 
programmers which deal with a given assembly are many® (See also the 
notes under Commenting Assembly Language Programs®) 

PDP-11 assembly language programming best follows a tree-like 
structure with the top of the tree being the final results and the 
base being the smallest component function© (The Assembler itself is 
a tree structure and is briefly described in Figure 1-1®) 







Figure 1-1 

Problem Oriented Tree-Structure 
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1*1*1 Commenting PDP-11 Assembly Language Programs 

When programming in a modular fashion, it is desirable to heavily 
comment the beginning of each subroutine, telling what that routine 
doesi its inputs , outputs 8 and register usage® 

Since subroutines are short and encompass only one operation it is not 
necessary to tell how the subroutine functions 9 but only what it does® 
An explanation of how a subroutine functions should be documented only 
when the procedure is not obvious to the reader® This enables any 
later inspection of an unclear subroutine to disclose the maximum 
amount of useful information to the reader® 


1®1®2 Localised Register Usage 

A useful technique in writing subroutines is to save all registers 
upon entering a subroutine and restore them prior to leaving the 
subroutine® This allows the programmer unrestricted use of the PDP-11 
registers, including the program stacks during a subroutine® 

Use of registers avoids 2- and 3-word addressing instructions® The 
code in Figure 1-2 compares the use of registers with symbolic 
addressing® Register use is faster and requires less storage space 
than symbolic addressing® 


1 ®TFT 


2 

002060 


10$ s 

CALL 

20$ 

fMOVE A CHARACTER 

3 

002064 

003375 


BGT 

10$ 

fLOOP IF GT ZERO 

4 

002066 

001432 


BFQ 

19$ 

f END IF ZERO 

5 

002070 

114200 


MOVE 

-(R2),R0 

1TERMINATOR, BACK UP 

6 

002072 

020027 


CMP 

R0,#MT,MAX 

1POINTER 
!END OF TYPE? 

7 

002076 

177603 

101453 


BLOS 

22$ 

| YES 

8 

002100 

010146 


MOV 

R1,-(SP) 

I REMEMBER READ POINTER 

9 

10 
11 

002102 

02106 

02110 

016701 
002034 ® 
005721 
010203 


MOV 

TST 

MOV 

MSBARG s R1 

(Rl) + 

R2,R3 

I AND WRITE POINTER 

12 

02112 

005400 


NFG 

R0 

|ASSUME MACRO 

13 

02114 

026727 


CMP 

MSBTYP,#MT,MAC 

fTRUE? 

14 

02122 

002026 s 

177603 

001402 


BFQ 

12$ 

1 YES, USE IT 

15 

02124 

016700 


MOV 

msbcnt.ro 

I GET ARG NUMBER 

16 

02130 

002036 8 
010302 

12$: 

MOV 

& 

6a 

en 

PS 

fRESET WRITE POINTER 

17 

02132 


13$: 

CALI 

20$ 

fMOVE A BYTE 

18 

02136 

003375 


BGT 

13$ 

fLOOP IF PNZ 

19 

02140 

002402 


BLT 

14$ 

f END IF LESS THAN ZERO 

20 

02142 

005300 


DFC 

R0 

fARE WE THERE YET? 

21 

02144 

003371 


BGT 

12$ 

f NO 

22 

02146 

105742 

14$: 

TSTB 

“ (R2) 

fYES BACK UP POINTER 

23 

02150 

012601 


MOV 

(SP)+,R1 

fRESET READ POINTER 

24 

Q2152 

000742 


BR 

10$ 

fEND OF ARGUMENT 

25 

26 

02154 

010167 

19$: 

MOV 

Rl,MSBMRP 

f SUBSTITUTION 

fEND OF LINE, SAVE 
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27 

02160 

002042' 

052767 


BIS 

#LC,ME,LCFLAG 

|POINTER 

1 FLAG AS MACRO 

28 

29 

30 

02166 

02170 

000400 

000010’ 

000726 

032701 

20$: 

BR 

BTT 

9$ 

#PPMB-1„R1 

1EXPANSION 

IMACRO, END OF BLOCK? 

31 

02174 

000017 

001003 


BNE 

21$ 

I NO 

32 . 

02176 

016101 


MOV 

-PPMB(Rl) t Rl 

IYES 8 POINT TO NEXT 

33 

02202 

177760 

005721 


TST 

(Rl) + 

IBLOCK 

fMOVE FAST LINK 

34 

02204 

020227 

21$: 

CMP 

R2,#LINBUF+SRCLFN ;OVERFLOW? 

35 

02210 

101404 


BLOS 

23$ 

1 NO 

36 

37 

02212 

02220 

105742 


ERROR 

TSTB 

L 

-(R2) 

|YES f FLAG ERROR 

I AND MOVE POINTER 

38 

02222 

112122 

23$: 

MOVB 

(Rl) +, (R2) + 

I BACK 

fMOVE CHAR INTO LINE 

39 

40 

41 

02224 

02226 


22$: 

RETURN 

CALL ENDMAC 

fBUFFER 

fCLOSE MACRO 

42 

43 

44 

45 

02232 

000167 

177326 


JMP 

*ENDC 

1$ 



Figure 1-2 

Segment of PDP-11 Code 
Showing 1, 2, and 3-Word Instructions 
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1®1®3 Conditional Assemblies 

Conditional assemblies are valuable in macro definitions® The 
expansion of a macro can be altered during assembly as a result of 
specific arguments passed and their use in conditionals® For example^ 
a macro can be written to handle a given data item differently^ 
depending upon the value of the item® Only a single algorithm need be 
expanded with each macro call® {Conditionals are described in detail 
in Section 5®?®) 

Conditional assemblies can also be used to generate different versions 
of a program from a single source® This is usually done as a result 
of one or more symbols being either defined or undefined® Conditional 
assemblies are preferred to the creation of a multiplicity of sources® 
This principle is followed in the creation of PDP-11 system programs 
for the following reasons! 

1® Maintenance of a single source program is easier 8 and 
guarantees that a change in one version of the program 9 which 
may affect other versions 9 is reflected automatically in all 
possible versions® 

2® Distribution of a single source program allows a customer or 
individual user to tailor a system to his configuration and 
needs® and continue to update the system as the hardware 
environment or programming requirements change® 

3® As in the case of maintenance^ the debugging and checkout 
phase of a single program (even one containing many separate 
modules) is easier than testing several distinct versions of 
the same basic program® 


1®2 REENTRANT CODE 

Both the interrupt handling hardware and the subroutine call 
instructions (JSR* RTS 8 EMT^ and TRAP) facilitate writing reentrant 
code for the PDP-11® Reentrant code allows a single copy of a given 
subroutine or program to be shared by more than one process or task® 
This reduces the amount of core needed for multi-task applications 
such as the concurrent servicing of peripheral devices® 

On the PDP-11 9 reentrant code depends upon the stack for storage of 
temporary data values and the current processing status® Presence of 
information in the stack is not affected by the changing of 
operational control from one task to another® Control is always able 
to return to complete an operation which was begun earlier but not 
completed® 


1.3 PREFERRED ADDRESSING MODES 

Addressing modes are described in detail in Chapter 4® Basically^ the 
PDP-11 programmer has eight types of register addressing and four 
types of addressing through the PC register® Those operations 
involving general register addressing -take one word of core storage 9 
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to three words. For examples 


while symbolic addressing can use up 

MOV A,B ;THREE WORDS OF STORAGE 

MOV R0,R1 ;ONE WORD OF STORAGE 


The user is advised to perform as many operations as possible with 
register addressing modes, and to use the remaining addressing modes 
to preset the registers for an operation. This technique saves space 
and time over the course of a program. 


1.4 PARAMETER ASSIGNMENTS 

Parameter assignments should be used to enable a program to be easily 
followed through the use of a symbolic cross reference (CREF listing)® 
For examples 

SYM—42 


MOV #SYM # RG 

Another standard PDP-11 convention is to name the general registers as 
follows I 

RO = %0 

Rl 88 %1 

R2 « %2 

R3 « %3 

R4 * %4 

R5 as %5 

SP » %6 (processor stack pointer) 

PC « %7 (program counter) 


1.5 SPACE VS® TIMING TRADEOFFS 

On the PDF 8 ® 11 as on all computers^ some techniques lead to savings in 
storage space and others lead to decreased execution time® Only the 
Individual user can determine which Is the best combination of th.e two 
for his application® It is the purpose of this section to describe 
several means of conserving core storage and/or saving time® 


1.5.1 Trap Handler 

The use of the trap handler and a dispatch table conserves core 
requirements in subroutine calling 9 but can lead to a decrease xn 
execution speed due to indirect transfer of control© To illustrate 9 a 
subroutine call can be made in either of the following waysi 

1. A JSR instruction which generally requires two PDP-11 wordsi 

JSR R5 e SUBA 

but is direct and fast® 
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2® A TRAP instruction which requires one in-line PDP-11 wordi 
TRAP N 

but is indirect and slower® The TRAP handler must use N to 
index through a dispatch table of subroutine addresses and 
then JMP to the Nth subroutine in the table® 


1*5®2 Register Increment 
The operationi 

CMPB (R0>+,(R0)+ 
is preferable toi 

TST (RO) 4* 

to increment RO by 2 9 especially where the initial contents of RO may 
be odd^ but slower® 


1*6 CONDITIONAL BRANCH INSTRUCTIONS 

When using the PDP-11 conditional branch instructions , it is 
imperative that the correct choice be made between the signed and the 
unsigned branches® 


SIGNED 

UNSIGNED 

BGE 

BHIS 

(BCC) 

BLT 

BLO 


BGT 

BHI 


BLE 

BLOS 

(BCS) 


A common error is to use a signed branch (e @ g® # BGT) when comparing 
two memory addresses® A problem occurs when the two addresses have 
opposite signsi that is* one address goes across the 16K (100000(8)) 
boundary® This type of coding error usually appears as a result of 
relinking at different addresses and/or a change in the size of the 
program® 


1—8 



CHAPTER 2 


SOURCE PROGRAM FORMAT 


A source program is composed of a sequence of source lines 9 where each 
line contains a single assembly language statement® Each line is 
terminated by either a line feed or a vertical-tab character (which 
increments the line count by 1) or a form-feed character (which 
increments both the line count and page count by 1). 

Since the MACH Interface automatically appends a line feed at the end 
of every logical input line*? the user need not concern himself with 
the statement terminator® Hoirever* a carriage return character not 
followed by a statement terminator generates an error flag® A legal 
statement terminator not immediately preceded by a carriage return 
causes the Assembler to insert a carriage return character for listing 
purposes® 

An assembly language line can contain up to BO (10) characters 
(exclusive of the statement terminator). Beyond this limit* excess 
characters are ignored and generate an error flag® 


2.1 STATEMENT FORMAT 

A statement can contain up to four fields which are identified by 
order of appearance and by specified terminating characters. The 

general foirmair o£ a MAG11 assembly language statement is? 

labeli operator operand Icomments 

The label and comment fields are optional. The operator and operand 
fields are interdependent! either may be omitted depending upon the 
contents of the other. 

The Assembler interprets and processes these statements one by on@ f 
generating one or more binary instructions or data words or performing 
an assembly process® A statement must contain one of these fields and 
may contain all four types. (Blank lines are legal.) 

Some statements have one operand* for examples 

CLR R0 
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while others have two* 

MOV #ERR*R2 

An assembly language statement must be complete on one source line© 
No continuation lines are allowed® 

MAC11 source statements are formatted with the DOS-15 EDIT program 
such that use of the TAB character causes the statement fields to be 


aligned®. 

For examples 


Label 

Operator Operand 

Comment 

Field 

Field Field 

Field 


MASK-—10 




REGEXPs 



I REGISTER EXPRESSION 


ABSEXP 


fMUST BE ABSOLUTE 

REGTST! 

BIT 

#MASK,VALUE 

13 BITS? 


BEQ 

REGERX 

|YES * OK 

REGERRi 

ERROR 

R 

INO* ERROR 

REGERXi 

MOV 

#DEFFLG:REGFLG 

f MODE 


BIC 

#MASK,VALUE 



BR 

ABSERX 



2®1*1 Label Field 

A label is a user-defined symbol which is assigned the value of the 
current location counter and entered into the user-defined symbol 
table© The value of the label is absolute© 

A label is a symbolic means of referring to a specific location within 
a program© If present* a label always occurs first in a statement and 
must be terminated by a colon© For example* if the current location 
is absolute 100(8)* the statement! 

ABCDi MOV A*B 

assigns the value 100 (8) to -the label ABCD« Subsequent reference to 
ABCD references location 100(8)© 

More than one label may appear within a single label fieldi each 
label within the field has the same value* For example 9 if the 
current location counter is 100(8)* the multiple labels in the 
statement! 

ABCi $DDi A7*7i MOV A*B 

cause each of the three labels ABC* $DD* and A7®7 to be equated to the 
value 100(8)® 

The first six characters of a label are significant© An error code is 
generated if more than one label share the same first six characters® 

A symbol used as a label may not be redefined within the user program® 
An attempt to redefine a label results in an error flag in the 
assembly listing© 
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2 @ 1®2 Operator Field 


An operator field follows the label field in a statement, and may 
contain a macro call, an instruction mnemonic* or an assembler 
directive® The operator may be preceded by n©n@ f one or more labels 
and may be followed by one or more operands and/or a comment® Leading 
and trailing spaces and tabs are ignored® 

When the operator is a macro call, the Assembler inserts the 
appropriate code to expand the macro® When the operator is an 
instruction'mnemonic* it specifies the instruction to be generated and 
the action to be performed on any operand(s) which follow® When the 
operator is an Assembler directive* it specifies a certain function or 
action to be performed during assembly® 

An operator is legally terminated by a space* tab* or any 
non-alphanumerie character (symbol component). 

Consider the following examplesi 

MOV A*B (space terminates the operator MOV) 

MOV@A*B (@ terminates the operator MOV) 

When the statement line does not contain an operand or comment* the 
operator is terminated by a carriage return followed by a line feed* 
vertical tab or form feed character® 

A blank operator field is interpreted as a @ WORB assembler directive 
(see Section 5® 3 e 2)® 


2®1*3 Operand Field 

An operand is that part of a statement which is manipulated by the 
operator® Operands may be expressions* numbers* or symbolic or macro 
arguments (within the context of the operation) v When multiple 
operands appear within a statement* each is separated from the next by 
one of the following charactersi comma* tab* space or paired angle 
brackets around one or more operands (see Section 3®1®1)® An operand 
may be preceded by an operator* label or other operand and followed by 

at comment® 

The operand field is terminated by a semicolon when followed by a 
comment* or by a statement terminator when the operand completes the 
statement® For examples 

LABELS MOV A*B ICOMMENT 

The space between MOV and A terminates the operator field and begins 
the. operand field? a comma separates the operands A and B? a 
semicolon terminates the operand field and begins the comment field® 


2*1*4 Comment Field 

The comment field is optional and may contain any ASCII characters 
except null * rubout* carriage return * line feed* vertical tab or form 
feed* All other characters* even special characters with a defined 



usage, are ignored by the Assembler when appearing in the comment 
field. 

The comment field may be preceded by one, any, none or all of the 
other three field types. Comments must begin with the semicolon 
character and end with a statement terminator. 

Comments do not affect assembly processing or program execution, but 
are useful in source listings for later analysis, debugging, or 
documentation purposes. 


2.2 FORMAT CONTROL 

Horizontal or line formatting of the source program is controlled by 
the space and tab characters. These characters have no effect on the 
assembly process unless they are embedded within a symbol, number, or 
ASCH text; or unless they are used as the operator field terminator. 
Thus, these characters can be used to provide an orderly source 
program. A statement can be written: 

LABEL:MOV(SP)+,TAG;POP VALUE OFF STACK 

or, using formatting characters, it can be written: 


LABEL: MOV (SP)+,TAG ;POP VALUE OFF STACK 


which is easier to read in the context of a source program listing. 


Vertical formatting, i.e 
character. A page of 
(type the CTRL/FORM keys 


, page size, is controlled by the form feed 
n lines is created by inserting a form feed 
on the keyboard) after the nth line. 
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CHAPTER 3 


SYMBOLS AND EXPRESSIONS 


This Chapter describes the various components of legal MACH 
expressions! the Assembler character set*, symbol construction 
numbere s operators § terms and expressions* 


3*1 CHARACTER SET 

The following characters are legal in MACH source programsi 

1* The letters A through Z® Both upper and lower case letters 
are acceptable although § upon input f lower case letters are 
converted to upper case letters® Lower case letters can only 
be output by sending their ASCII values to the output device® 
This conversion is not true for s ©ASCII § ©ASCIZ^ 1 (single 
quote) or m (double quote) 'statements if ©RNABL LC is in 
effect® 

2© The digits 0 through 9® 

3® Th© characters ® (period or dot) and $ (dollar sign ) 9 
The special characters are as followsi 


Character Designation 

carriage return 
line feed 
form feed 
vertical tab 
! colon 

* equal sign 

% percent sign 

tab 


Function 

formatting character 

source statement terminators 

label terminator 
direct assignment indicator 
register term indicator 
item or field terminator 




space 


# 

§ 

( 

) 

S 

# 

< 

> 

+ 


& 

/ 

& 

I 

88 

§ 

t 

\ 


item or field terminator 

number sign immediate expression indicator 

at sign deferred addressing indicator 

left parenthesis initial register indicator 

right parenthesis terminal register indicator 

comma operand field separator 

semi-colon comment field indicator 

left angle bracket initial argument or expression 

indicator 

right angle bracket terminal argument or expression 

indicator 

arithmetic addition operator or 
autoincrement indicator 

arithmetic subtraction operator 
or autodecrement indicator 

arithmetic multiplication operator 

arithmetic division operator 

logical AND operator 

logical inclusive OR operator 

double ASCII character indicator 

single ASCII character Indicator 

universal operator , 
argument indicator 

macro numeric argument indicator 


plus sign 

minus sign 

asterisk 
slash 
ampersand 
exclamation 
double quote 
single quote 
up arrow 

backslash 




3*1 0 X Separating and Delimiting Characters 

Reference is made in the remainder of the manual to legal separating 
characters and legal argument delimiters• These terms are defined in 
Tables 3-1 and 3-2* 
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Table 3-1 

Legal Separating Characters 


Character 

Definition 

Usage 

space 

one or more spaces 

A space is a legal separator only 

and/or tabs 

for argument operands. Spaces 
within expressions are ignored (see 
Section 3.8). 

9 

comma 

A comma is a legal separator for 
both expressions and the argument 
operands. 


Table 3-2 

Legal Delimiting Characters 


Character 

Definition 

Usage 

^ ©. ® ^ 

paired angle brackets 

Paired angle brackets are used to 
enclose an argument, particularly 
when that argument contains 
separating characters. Paired 
angle brackets may be used anywhere 
in a program to enclose an 
expression for treatment as a term® 


Up arrow construction 
where the up arrow 
character is followed 
by an argument 
bracketed by any 
paired printing 
characters 0 

This construction is equivalent in 
function to the paired angle 
brackets and is generally used only 
where the argument contains angle 
brackets• 


Where argument delimiting characters are used^ they must bracket the 
first (andj? optionally , any following) argument(s) • The character < 
and tiie characters t \ 8 wiiere \ Is any printing character^ can Jbe 
considered unary operators which cannot be immediately preceded by 
another argument® For examples 

•MACRO TEM <AB>C 

indicates a macro definition with two arguments , while 
.MACRO TEL C<AB> 

has only one argument. The closing or matching character where the 
up arrow construction is used f acts as a separator. The opening 
argument delimiter does not act as an argument separator. 

Angle brackets can be nested as followsi 

<A<B>C> 
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which reduces toi 
A<B>C 

and is considered to be one argument in both forms. 


3.1® 2 Illegal Characters 

A character can be illegal in one of two waysi 

1® A character which is not recognised as an element of the 
MAC 11 character set is always an illegal character and causes 
immediate termination of the current line at that pointy plus 
the output of an error flag in the assembly listing s For 
example: 

LABELS As MOV A*B 

Since the backarrow is not a recognized character^ the entire 
line is treated as at 

.WORD LABEL 

statement and is flagged in the listing. 

2. A legal MACH character may be illegal in contexts Such a 
character generates a Q error on the assembly listing® 


3.1.3 Operator Characters 

Legal unary operators under MACH are as followsi 


Unary 

Operator Explanation 


Example 


4* plus sign 


+A 


(positive value of A r 
equivalent to A) 


t 


minus sign 

-A 

up arrow , 

tC24(8) 

universal unary 
operator (this 
usage is described 
in greater detail 
in Sections 5 0 4.2 

tD127 

and 5.6.2). 

t034 


fBllOOOlll 


(negative f 2 § s complement , 
value of A) 

(interprets the l 9 s complement 
value of 24(8)) 

(interprets 127 as a decimal 
number) 

(interprets 34 as an octal 
number) 

(interprets 11000111 as a 
binary value) 


The unary operators as described above can be used adjacent to each 
other in a term. For example! 


-%5 
tCf012 


Legal binary operators under MACH are as follows t 
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Example 


Binary 


Operator 

Explanation 


+ 

addition 

A+B 

— 

subtraction 

A-B 


multiplication 

A*B 

/ 

division 

A/B 

& 

logical AND 

Am 

! 

logical inclusive OR 

A1B 


(16-bit product returned) 
(16-bit quotient returned) 


All binary operators have the same priority. Items can be grouped for 
evaluation within an expression by enclosure in angle brackets . Terms 
in angle brackets are evaluated first, and remaining operations are 
performed left to right. For examples 


.WORD 1+2*3 ;IS 11 OCTAL 

.WORD l+<2*3> 7 IS 7 OCTAL 


3.2 MACH SYMBOLS 


There are three types of symbols s permanent, user-defined and macro. 
MACll maintains three types of symbol tables % the Permanent Symbol 
Table (PST), the User Symbol Table (UST) and the Macro Symbol Table 
(MST). The PST contains all the permanent symbols. The UST and MST 
are constructed as the source program is assembled? user-defined 
symbols are added to the table as they are encountered. 


3.2.1 Permanent Symbols 

Permanent symbols consist of the instruction mnemonics (Appendix B.3) 
and assembler directives (Chapters 5 and 6, Appendix B). These symbols 
are a permanent part of the Assembler and need not be defined before 
being used in the source program. 


3.2.2 User-Defined and MACRO Symbols 

User-defined symbols are those used as labels (Section 2.1.1) or 
defined by direct assignment (Section 3.3). These symbols are added to 

the User- Symbol Table as -they are encountered during- the first pass of 
the assembly* Macro symbols are those symbols used as macro names 
(Section 6*1)® These symbols are added to the Macro Symbol Table as 
they are encountered during the assembly® 

User-defined. and macro symbols can be composed of alphanumeric 
characters, dollar signs f and periods only; any other character is 
illegal® 

The following rules apply to the creation of user^defined and macro 
symbols t 

1® The first character must not be a number® 

2* Each symbol must be unique within the first six characters® 

3® A symbol can be written with more than six legal characters, 
but the seventh and subsequent characters are only checked 
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for legality^ and are not otherwise recognized by the 
Assembler® 

4® Spaces, tabs^ and illegal characters must not be embedded 
within a symbol® 

The value of a symbol depends upon its use in the program® A symbol 
in the operator field may be any one of the three symbol types® To 
determine the value of the symbol, the Assembler searches the three 
symbol tables in the following orders 

l e Macro Symbol Table 
2* Permanent Symbol Table 
3* User-defined Symbol Table 

A symbol found in the operand field is sought in the 

1® User-defined Symbol Table 
2® Permanent Symbol Table 

in that order® The Assembler never expects to find a macro name in an 
operand field® 

These search orders allow redefinition of Permanent Symbol Table 
entries as user-defined or macro symbols® The same name can also be 
assigned to both a macro and a label® 

All user-defined symbols are internal and must be defined within the 
current assembly® 


3.3 DIRECT ASSIGNMENTS 

A direct assignment statement associates a symbol with a value® When 
a direct assignment statement defines a symbol for the first time, 
that symbol is entered into the user symbol table and the specified 
value is associated with it® A symbol may be redefined by assigning a 
new value to a previously defined symbol® The latest assigned value 
replaces any previous value assigned to a symbol® 

The general format for a direct assignment statement isi 


symbol « expression 


Symbols take 
For examplei 

on the absolute 

attribute of their 

defining expression® 


A = 1 

ITHE SYMBOL A 
;VALUE 1® 

IS EQUATED 

TO THE 


B— 1 A-1&MASKLOW 

fTHE SYMBOL B 

1VALUE OF THE 

IS EQUATED TO 
EXPRESSION. 

THE 

Cs 

D * 3 

fTHE SYMBOL D 

IS EQUATED TO 

3. 

El 

MOV SIZABLE 

1LABELS C AND E ARE EQUATED TO THE 
?LOCATION OF THE MOV COMMAND. 


The following conventions apply to direct assignment statementsi 
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1® An equal sign («) must separate the symbol from the 

expression defining the symbol value® 

2® A direct assignment statement is usually placed in the 
operator field and may be preceded by a label and followed by 
a comment® 

3® Only one symbol can be defined by any one direct assignment 
statement® 

4® Only one level of forward referencing is allowed® 

Example of two levels of forward referencing (illegal)s 

X = Y 
Y ® Z 
Z = 1 

X and Y are both undefined throughout pass 1® X is undefined 
throughout pass 2 and causes a U error flag in the assembly listing® 


3.4 REGISTER SYMBOLS 

The eight general registers of the PDP-11 are numbered 0 through 7 and 
can be expressed in the source program as: 

%0 

%1 


%7 

where the digit indicating the specific register can be replaced by 
any legal term which can be evaluated during the first assembly pass® 

!t is recommended that the programmer create and use symbolic names 
for all register references® A register symbol is defined in a direct 
assignment statement^ among the first statements in the program© The 
defining expression ©f a register symbol must be absolute© For 
examplei 


8 


9 

000000 

R0—%0 

10 

000001 

R1“%1 

11 

000002 

R2=%2 

12 

000003 

R3=%3 

13 

000004 

R4=%4 

14 

000005 

R5—%5 

15 

000006 

R6=%6 

16 

000006 

SP-%6 

17 

000007 

PC=%7 

18 

000007 

R7=%7 

19 



I REGISTER DEFINITION 
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The symbolic names assigned to the registers in the example above are 
the conventional names used in all PDP-11 system programs* Since 
these names are fairly mnemonic f it is suggested the user follow this 
convention® Registers 6 and 7 are given special nam.es because of 
their special functions, while registers 0 through 5 are given similar 
names to denote their status as general purpose registers * 

AH register symbols must be defined before they are referenced. A 
forward reference to a register symbol is flagged as an error© 

The % character can be used with any term or expression to specify a 
register® (A register expression less than 0 or greater 'than 1 is 
flagged with an R error code.5 For examples 

CLR %3+X 

is equivalent to 
CLR %4 

and clears the contents of register 4 # while 
CLR 4 

clears the contents of memory address 4 * 

In certain cases a register can be referenced without the use of a 
register symbol or register expressioni these cases are recognised 
through the context of the statement® An example is shown belowi 

JSR 5 i SUBR |FIRST OPERAND FIELD MUST ALWAYS BE A REGISTER 


3®5 LOCAL SYMBOLS 

Local symbols are specially formatted symbols used as labels within a 
given range® ^ Use of local symbols can achieve considerable savings in 
core space within the user symbol table© Core cost is one word for 
each local symbol m each local symbol blocks as compared with four 
words of storage for each label stored in the user symbol tables 

Local symbols provide a convenient means of generating labels for 
branch instructions* etc. Use of local symbols reduces the 
possibility of multiply-defined symbols within a user program and 
separates entry point symbols from local references© Local symbols 
are not referenced from outside their local symbol block© 

Local symbols are of the form n$ where n is a decimal integer from 1 

to 121 p inclusive* and can only be used on word boundaries* Local 
symbols includei 

1 $ 

27$ 

59$ 

104$ 

Within a local symbol blocks local symbols can be defined and 
referenced^ However* a local symbol cannot be referenced outside the 
block in which it is defined® There is no conflict with labels of the 
same name in other local symbol blocks© 
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Local symbols 64$ through 127$ can be generated automatically as a 
feature of the macro processor (see Section 6.3.5 for further 
details). When using local symbols, the user is advised to first use 
the range from 1$ to 63$. 

A local symbol block is delimited in one of the following waysi 

1. The range of a single local symbol block can consist of those 
statements between two normally constructed symbol labels. 
(Note that a statement of the form 

LABEL™. 

is a direct assignment, does not create a label in the strict 
sense, and does not delimit a local range.) 

2. The range of a single local symbol block can be delimited 
with the .ENABL LSB and the first symbolic label. The 
default for LSB is off. 

For examples of local symbols and local symbol blocks, see Figure 3-3. 


Ln. Octal 

No. Expansion Source Code Comments 


1 .SBTTL SECTOR INITIALIZATION 

2 
3 
8 

9 

10 000000 

11 00000 XCTPRGs 


12 

00000 

012700 

000000 


MOV 

13 

00004 

005020 

i$ . 

CLR 

14 

00006 

022700 

000040 


CMP 

15 

00012 

101374 


BHI 

16 





17 


000000 



18 

00000 


XCTPAS s 


19 

00000 

012700 

000000 


MOV 

20 

00004 

005020 

1$: 

CLR 

21 

00006 

022700 

000040 


CMP 

22 

00012 

101374 


BHI 

23 





24 


000000 



25 

00000 


XCTLIN; 


26 

00020 

012700 

000000 


MOV 

27 

00004 

005020 

1$: 

CLR 

28 

00006 

022700 

000040 


CMP 

29 

00012 

101374 


BHI 

30 






#IMPURE,R0 

(R0)+ ?CLEAR IMPURE AREA 

#IMPTOP,R0 

1 $ 

?PASS INITIALIZATION 

I CODE 

# IMPPAS , R0 

(RO)-S- ; CLEAR IMPURE PART 

#IMPTOP ,R0 

1 $ 

;LINE INITIALIZATION 

; CODE 

#IMPLIN,R0 
(R0) + 

#IMPTOP,R0 
1 $ 




31 


000000 


MIXED MODE SECTOR 


Figure 3-3 

Assembly Source Listing of MACH Code 
Showing Local Symbol Blocks 


The maximum offset of a local symbol from the base of its local symbol 
blocks is 128 decimal words. Symbols beyond this range are flagged 
with an A error code. 


3.6 ASSEMBLY LOCATION COUNTER 

The period (.) is the symbol for the assembly location counter. When 
used in the operand field of an instruction, it represents the address 
of the first word of the instruction. When used in the operand field 
of an assembler directive, it represents the address of the current 
byte or word. For examples 

As MOV #.,R0 I. REFERS TO LOCATION A, 

;I,E., THE ADDRESS OF THE 
;MOV INSTRUCTION. 

(# is explained in Section 5.9.) 

At the beginning of each assembly pass, the Assembler clears the 
location counter. Normally, consecutive memory locations are assigned 
to each byte of binary data generated. However, the location of the 
stored binary data may be changed by a direct assignment altering the 
location counter. 

.^expression 

The expression defining the location counter must not contain forward 
references or symbols that vary from one pass to another. 

Examples t 


.=500 


FIRST: MOV .+10,COUNT 


.=520 


SECOND: MOV .,INDEX 


.=.+20 


P SET LOCATION COUNTER TO ABSOLUTE 
1500 

?THE LABEL FIRST HAS THE VALUE 500 (8) 

;.+10 EQUALS 510(8)„ THE CONTENTS OF 
JTHE LOCATION 510(8) WILL BE DEPOSITED 
;IN LOCATION COUNT. 

ITHE ASSEMBLY LOCATION COUNTER NOW 
IHAS A VALUE OF ABSOLUTE 520(8). 

ITHE LABEL SECOND HAS THE VALUE 520(8) 
fTHE CONTENTS OF LOCATION 520(8), THAT 
I IS, THE BINARY CODE FOR THE INSTRUCTION 
;ITSELF, WILL BE DEPOSITED IN LOCATION 
IINDEX. 

;SET LOCATION COUNTER TO ABSOLUTE 540 OF 
;THE PROGRAM SECTION. 
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THIRD! 


WORD 0 


®THE LABEL THIRD HAS THE VALUE OF 
;ABSOLUTE 540. 


Storage area may be reserved by advancing the location counter. For 
example, if the current value of the location counter is 1000, the 
direct assignment statement 

.=.+100 

reserves 100 (8) bytes of storage space in the program. The next 
instruction is stored at 1100. 


3.7 NUMBERS 

The MAC11 Assembler assumes all numbers in the source program are to 
be interpreted in octal radix unless otherwise specified. The assumed 
radix can be altered with the .RADIX directive (see Section 5.4.1) or 
individual numbers can be treated as being of decimal, binary, or 
octal radix (see Section 5.4.2). 

Octal numbers consist of the digits 0 through 7 only. A number not 
specified as a decimal number and containing an 8 or 9 is flagged with 
an N error code and treated as a decimal number. 

Negative numbers are preceded by a minus sign (the Assembler 
translates them into 2's complement form). Positive numbers may be 
preceded by a plus sign, although this is not required. 

A number which is too large to fit into 16 bits (177777<n) is 
truncated from the left and flagged with a T error code in the 
assembly listing. 


3.8 TERMS 

A term is a component of an expression. A term may be one of the 
following: 

1, A number, as defined in Section 3.7, whose 16-bit value is 

tisedo 

2* A symbol # as defined earlier in the chapter® Symbols are 
interpreted according to the following hierarchy! 

a* a period causes the value of the current location counter 
to be used® 

be a permanent symbol whose basic value is used and whose 
arguments (if any) are ignored® 

c® an undefined symbol is assigned a value of zero and 
inserted in the user^defined symbol table® 

3 ffl An ASCII conversion using either an apostrophe followed by a 
single ASCII character or a double quote followed by two 
ASCII characters which results in a word containing the 7-bit 
ASCII value of the character(s)• (This construction is 
explained in greater detail in Section 5®3®3®} 




4. A term may also be an expression or term enclosed in angle 
brackets. Any quantity enclosed in angle brackets is 
evaluated before the remainder of the expression in which it 
is found. Angle brackets are used to alter the left to right 
evaluation of expressions (to differentiate between A*B+C and 
A*<B+c> ) or to apply a unary operator to an entire expression 
(-<A+B>, for example). 

3.9 EXPRESSIONS 

Expressions are combinations of terms joined together by binary 
operators and which reduce to a 16-bit value. The operands of a .BYTE 
directive (see Section 5.3.1) are evaluated as word expressions before 
truncation to the low-order eight bits. Prior to truncation, the 
high-order.byte must be zero or all ones (when byte value is negative, 
the sign bit is propagated). 

Expressions are evaluated left to right with no operator hierarchy 
rules except that unary operators take precedence over binary 
operators. A term preceded by a unary operator can be considered as 
containing that unary operator. (Terms are evaluated, where 
necessary, before their use in expressions.) Multiple unary operators 
are valid and are treated as follows; 


—+—A 


is equivalent to 

-<+<-A>> 

A missing term, expression, or external symbol is interpreted as a 
zero. A missing operator is interpreted as +. A Q error flag is 
generated for each missing term or operator. For examples 

TAG I LA 177777 

is evaluated as 

TAG I LA+177777 

with a Q error flag on the assembly listing line. 

The value of an expression is the value of the absolute part of the 
expression; e.g., 

A — 5 
. = 20 

TAG s MOV TAG+A,R0 ;SET R0 TO 25 (8). 
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CHAPTER 4 


ADDRESSING MODES 


The program counter (PC, register 7 of the eight general registers) 
always contains the address of the next word to be fetehedf ±,e, f the 
address of the next instruction to be executed, or the second or third 
word of the current instruction® 

In order to understand how the address modes operate and how they 
assemble, the action of the program counter must be understood® The 
key rule isi 


Whenever the processor implicitly uses 
the program counter to fetch a word from 
memory , the program counter is 
automatically incremented by two after 
the fetch» 

That is, when an instruction is fetched , the PC is incremented by two, 
so that it is pointing to th© next word in memoryi and, if an 
instruction uses indexing (Sections 4® 7, 4®8 and 4®11) the processor 
uses the program counter to fetch the base from memory® Hence, using 
the rule above, the PC increments by two, and now points to the next 
word® 

The following conventions are used in this Sectioni 

1® Let E be any expression as defined in Chapter 3 @ 

2® Let R be a register expression® This is any expression 
containing a term preceded by a % character or a symbol 
previously equated to such a term® 

Examples: 

RO « %0 |GENERAL REGISTER 0 

Ri « ROHhl | GENERAL REGISTER 1 

R2 - 1+%1 | GENERAL REGISTER 2 

3® Let ER be a register expression or an expression in the range 
0 to 7 inclusive® 

4® Let A be a general 'address specification which produces a 
6-bit mode address field as described in Sections 3®1 and 3 @ 2 
of the PDP-11 Processor Handbook (both 11/20 and 11/45 
versions)® 
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The addressing specifications^ A # can be explained in terms of E, 
and ER as defined above® Each is illustrated with the single operand 
instruction CLR or double operand instruction MOV. 


4 e1 REGISTER MODE 

The register contains the operand® 

Format for At R 

Examples s R0-%0 

CLR RO 


I DEFINE RO AS REGISTER 0 
I CLEAR REGISTER 0 


4*2 REGISTER DEFERRED MODE 


The register contains the address of the operand® 

Format for As ffi or (ER) 

Examples i CLR @R1 fBOTH INSTRUCTIONS CLEAR 

CLR (1) ITHE WORD AT THE ADDRESS 

ICONTAINED IN REGISTER 1 


4 * 3 AUTOINCREMENT MODE 

The contents'of the register are incremented immediately after being 
used as the address of the operand® (See note below©) 


Format for At 

(ER) + 


Examples: 

CLR (RO) + 

fEACH INSTRUCTION CLEARS 


CLR (RO+3)+ 

fTHE WORD AT THE ADDRESS 


CLR (2) + 

1CONTAINED IN THE 

1 SPECIFIED REGISTER AND 

I INCREMENTS THAT 
;REGISTER 1 S CONTENTS BY 
1 TWO© 


NOTE 

Both JMP and ISR instructions using 
non-de£ erred autoincrement ntoda^ 
autoincrement the register before its 
use on the PDP-11/20 (but not on the 
PDP-11/45 or 11/05) e In double operand 
Instructions of the addressing form 
%R^(R)t or %R^-(R) where the source and 
destination registers are the same^ the 
source operand Is evaluated as the 
autoincremented or autodecremanted 
value? but the destination register^ at 
the time it is used^ still contains the 
originally intended effective address© 


X." 
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In the following two examples^ as 
executed on the PDP-Xl/20^ RO originally 



contains 100® 


MOV 

RO* (0)4- 

!THE QUANTITY 102 IS 

1MOVED TO LOCATION 100 

MOV 

R0,-(0) 

jTHE QUANTITY 76 IS MOVED 
jTO LOCATION 76 


The use of these forms should be avoided 
as they are not compatible with the 
PDP-11/05 and 11/45* 

A Z error code is printed with each instruction which is not 
compatible among all members of the PDP-11 family® This is merely a 
warning code® 


4*4 AUTOINCREMENT DEFERRED MODE 

The register contains the pointer to the address of the operand* The 
contents of the register are incremented after being used® 

Format for At @(ER) + 

Example! CLR @{3)t ICONTENTS OF REGISTER 3 

IPOINT TO ADDRESS OF WORD 
ITO BE CLEARED BEFORE 
IBEING INCREMENTED BY TWO 



4 * 5 AUTODECREMENT MODE 

The contents of the register are decremented before being used as the 
address of the operand (see note under autoincrement mode)* 


IDECREMENT CONTENTS OF 
I REGISTERS 0, 3 S AND 2 BY 
I TWO BEFORE USING AS 
IADDRESSES OF WORDS TO BE 
I CLEARED * 


The contents of the register are decremented before being used as the 
pointer to the address of the operand* 

Format for Ai (ER) 

Examplei CLR @-(2) fDECREMENT CONTENTS OF 

I REGISTER 2 BY TWO BEFORE 
IUSING AS POINTER TO 
IADDRESS OF WORD TO BE 
ICLEARED © 


Format for At 
Examplesi 


-(ER) 

CLR -(RO) 
CLR -(RO+3) 
CLR -(2) 




4*6 AUTODECREMENT DEFERRED MODE 
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4.7 INDEX MODE 


The value of an expression E is stored as the second or third word of 
the instruction. The effective address is calculated as the value of 
E plus the contents of register ER. The value E is called the base. 

Format for A: E(ER) 


Examplesi 


CLR X+2(Rl) 


CLR -2(3) 


;EFFECTIVE ADDRESS IS X+2 
IPLUS THE CONTENTS OF 
I REGISTER 1. 

IEFFECTIVE 

IADDRESS IS -2 PLUS THE 
}CONTENTS OF REGISTER 3. 


4.8 INDEX DEFERRED MODE 

address ^^the^operand COntents of a rQ 9 ister gives the pointer to the 

Format for As @E(ER) 

Examples CLR §14(4) jIF REGISTER 4 HOLDS 100 

IAND LOCATION 114 HOLDS 
12000, LOCATION 2000 IS 
ICLEARED. 


4.9 IMMEDIATE MODE 


The immediate mode allows the operand itself 
second or third word of the instruction. 
autoincrement of register 7, the PC. 


to be stored as the 
It is assembled as an 


Format for As #E 


JMOVE AN OCTAL 100 TO 
I REGISTER 0. MOVE THE 
IVALUE OF SYMBOL X TO 
;REGISTER 0. 

The operation of this mode is explained as follows. 

The statement MOV #100,R3 assembles as two words. These arei 

0 1 2 7 0 3 
0 0 0 1 0 0 


Examplesi 


MOV #100 f RO 
MOV #X, R0 


th^ h ffrT inin in ® t f" ct; |- on is fetched and executed, the PC points to 
s * word ° f th e instruction. The processor fetches the first 

^ auto increment the Pcf/ShS Se’pc^s used^as a°^i“er tiff etch the 

srss? srs sr■StiLSSJS- 0 befot * ^ i »™- 


4-4 



4®10 ABSOLUTE MODE 


Absolute mode is the equivalent of immediate mode deferred® @#E 
specifies an absolute address which is stored in the second or third 
word of the instruction® Absolute mode is assembled as an 
autoincrement deferred of register 7 9 the PC® 

Format for Ai @#E 

Examples! MOV @#100 # R0 IMOVE THE VALUE OF THE 

ICONTENTS OF LOCATION 100 
CLR @#X I TO REGISTER 0® CLEAR 

ITHE CONTENTS OF THE 
ILOCATION WHOSE ADDRESS 
!IS X© 


4® 11 RELATIVE MODE 

Relative mode is the normal mode for memory references® 

Format for At E 

Examples! CLR 100 fCLEAR LOCATION 100® 

MOV X F Y IMOVE CONTENTS OF 

ILOCATION X TO LOCATION 
IY® 

Relative mode is assembled as index mode^ using register 7 f the PC^ as 
the index register® The base of the address calculation 9 which Is 
stored in the second or third word of the instruction 9 Is not the 
address of the operand (as in index mode ) 9 but the number which 9 when 
added to the PC*? becomes the address of the operand® Thus^ the base 
is X^PC e which is called an offset® The operation Is explained as 
followsi 

If the statement MOV 100 f R3 Is assembled at absolute location 20 9 the 
assembled code Is s 

Location 20 % 0 1 6 7 0 3 

Location 22s 000054 

The processor fetches the MOV Instruction and adds two to the PC so 

that it points to location 22 e The source operand mode is 67f that is f 

indexed by the PC© To pick up the base f the processor fetches the 
word pointed to by the PC and adds two to the PC® The PC now points 
to location 24© To calculate the address of the source operand^ the 
base is added to the designated register© That is^ BASE+PC 8 *54+24«100 f 
the operand address© 

Since the Assembler considers 80 a 63 as the address of the first word of 
the instruction an equivalent index mode statement would bet 

MOV 100°~©«”>4 (PC) 9 R3 

This mode is called relative because the operand address is calculated 
relative to the current PC® The base is the distance or offset (in 
bytes) between the operand and the current PC© If the operator and 
its operand are moved In memory eo that the distance between the 
operator and data remains constant^ the instruction will operate 
correctly anywhere in core© 
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4.12 RELATIVE DEFERRED MODE 


Relative deferred mode is similar to relative mode^ except that the 
expression^ E, Is used as the pointer to the address of the operand® 

Format for At @E 


Example i MOV @X f R0 I MOVE THE CONTENTS OF THE 

ILOCATION WHOSE ADDRESS IS 
IIN X INTO REGISTER 0. 


4 a 13 

TABLE OF MODE FORMS AND CODES 

Each 

instruction takes at least 

one word® Operands of the first six 

forms 

listed below do 

not increase the length of an instruction. Each 

operand in one of the 

other modes f however f Increases the instruction 

length by one word. 




Form 

Mode 

Meaning 


R 

On 

Register mode 


@R or (ER) 

In 

Register deferred mode 


(ER) + 

2n 

Autoincrement mode 


@ (ER) + 

3n 

Autoincrament deferred mode 


-(ER) 

4n 

Autodecrement mod© 


(ER) 

5 n 

Autodeerem@nt deferred mode 

where 

n is the register number® 


Any of the following : 

forms adds 

on© word to the instruction lengths 


Form 

Mode 

Meaning 


E (ER) 

fin 

Index mod© 


@E (ER) 

7n 

Index deferred mod® 


#R 

27 

Immediate mode 


@#E 

37 

Absolut® memory reference mode 


E 

67 

Relative mode 


@E 

77 

Relative deferred reference mode 


where n is the register number® Note that in the last four forms f 
register 7 (the PC) is referenced® 

NOTE 

1® An alternate form for @R Is (ER) • 

However * the form @(ER) is equivalent to 
@0 (ER) . 

2 e The form @#E differs from the form E in 
that the second or third word of the 
instruction contains the absolute 
address of the operand rather than the 
relative distance between the operand 
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and the PC® Thue f the instruction 
CLR @#100 clears absolute location 100 
even if the instruction is moved from 
the point at which it was assembled® 


4®14 BRANCH INSTRUCTION ADDRESSING 

The branch instructions are l-word instructions © The high byte 
contains the op code and the low byte contains an 8-bit signed offset 
(7 bits plus sign) which specifies the branch address relative to the 
PC® The hardware calculates the branch address as followsi 

1® Extend the sign of the offset through bits 8-15® 

2® Multiply the result by 2® This creates a word offset rather 
than a byte offset® 

3© Add the result to the PC to form the final branch address® 

The Assembler performs the reverse operation to form the byte offset 
from the specified address® Remember that when the offset is added to 
the PC # the PC is pointing to the word following the branch 
instructioni hence the factor -2 in the calculation® 

Byte offset = (E-PC)/2 truncated to eight bits® 

Since PC - ®t2 F w@ have 

Byte offset ■ (e-«- 2)/2 truncated to eight bits® 

The EMT and TRAP instructions do not use the low-order byte of the 
word® This allows information to b@ transferred to the trap handlers 
in the low order byte© If EMT or TRAP is followed by an expression f 
the value is put into the low-order byte of the word© However^ if the 
expression is too big (>377(8)) it is truncated to eight bite and a T 
error flag is generated® 
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PART 111 


MACH ASSEMBLER DIRECTIVES 


Chapters 5 and 6 describe all MACH directives® Directives are 
statements which cause the Assembler to perform certain processing 
operations . Chapter 5 describes several types of directives including 
those to control symbol interpretation* listing header material* 
program sections § data storage format* assembly listings * and 
floating-point formats® Chapter 6 describes those directives having 
to do with macros* macro arguments f and repetitive coding situations® 

Assembler directives can be preceded by a labels subject to 
restrictions associated with specific directives* and followed by a 
comment® An assembler directive occupies the operator field of a 
MACH source line® Only one directive can be placed on any one line® 
Zero * one* or more operands can occupy the operand fieldi legal 
operands differ with each directive and may be symbols* expressions* 
or arguments® 









CHAPTER 5 


GENERAL ASSEMBLER DIRECTIVES 


5.1 LISTING CONTROL DIRECTIVES 


5.1.1 .LIST and .NLIST 

Listing options can be specified in the text of a MAC11 program 
through the .LIST and .NLIST directives. These are of the forms 

.LIST arg 
.NLIST arg 

where: 

arg represents one or more optional arguments. 

When used without arguments, the listing directives alter the listing 
level count. The listing level count causes the listing to be 
suppressed when it is negative. The count is initialized to zero, 
incremented for each .LIST and decremented for each .NLIST. For 
example: 

.MACRO LTEST ILIST TEST 

;A—THIS LINE SHOULD LIST 
.NLIST 

IB—THIS LINE SHOULD NOT LIST 
.NLIST 

fC-THIS LINE SHOULD NOT LIST 
.LIST 

;D—THIS LINE SHOULD NOT LIST (LEVEL NOT BACK TO ZERO) 

.LIST 

;E—THIS LINE SHOULD LIST (LEVEL BACK TO ZERO) 

„ENDM 

;LTEST #CALL THE MACRO 

;A-THIS LINE SHOULD LIST 
.NLIST 
.LIST 

jE-THIS LINE SHOULD LIST (LEVEL BACK TO ZERO) 

The primary purpose of the level count is to allow macro 
expansions to be selectively listed and yet exit with the level 
returned to the status current during the macro call. 

The use of arguments with the listing directives does not affect 
the level count; however, use of .LIST and .NLIST can be used to 
override the current listing control. For example: 
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MACRO XX 


.LIST iLIST NEXT LINE 

eNLIST | DO NOT LIST REMAINDER 

. IOF MACRO EXPANSION 


eENDM 

oNLIST ME iDO NOT LIST MACRO EXPANSIONS 

XX 

.LIST ILIST NEXT LIME 

X s3 ® 


Allowable arguments for use with the listing directives are as follows 
(these arguments can be used singly or in combination)i 


Argument Default 


Function 


SEQ 

list 

LOG 

list 

BIN 

list 

BEX 

list 

SRC 

list 

COM 

list 

MD 

list 

MC 

list 

ME 

no list 

MEB 

no list 


Controls the listing of source line sequence 
numbers. Error flags are normally printed on 
the line preceding the questionable source 
statement® 

Controls the listing of the location counter 
(this field would not normally be 
suppressed)* 

Controls the listing of generated binary 
code® 

Controls listing of binary extensionsi that 
is, those locations and binary contents 
beyond the first binary word {per source 
statement)• This is a subset of the BIN 
argument® 

Controls the listing of the source code® 

Controls the listing of comments® This is a 
subset of the SRC argument and can be used to 
reduce listing time and/or space where 
comments are unnecessary® 

Controls listing of macro definitions and 
repeat range expansions® 

Controls listing of macro calls and repeat 
range expressions® 

Controls listing of macro expansions® 

Controls listing of macro expansion binary 
code® A .LIST MEB causes only those macro 
expansion statements producing binary code to 
be listed® This Is a subset of the ME 
argument® 
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CND 






LD 


TOC 


TTM 


SYM 


list 


no list 


list 


Teletype 

mode 


list 


Controls the listing of unsatisfied 
conditions and. all ®XF and . ENDC statements* 
This argument permits conditional assemblies 
to be listed without including unsatisfied 
code. 

Control listing of all listing directives 
having no arguments (those used to alter the 
listing level count). 

Control listing of tables of contents on pass 
1 of the assembly (see Section 5.1.4 
describing the .SBTTL directive). The full 
assembly listing is printed during pass 1 of 
the assembly. 

Controls listing output format. The TTM 
argument (the default case) causes output 
lines to be truncated to 72 characters. 
Binary code is printed with the binary 
extensions below the first binary word. The 
alternative (.NLIST TTM) to Teletype mode is 
line printer mode, which is shown in Figure 
6 - 1 . 

Controls the listing of the symbol table for 
the assembly. 


An example of an assembly listing as sent to a 132-column line printer 
is shown in Figure 5-1. Notice that binary extensions for statements 
generating more than one word are spread horizontally on the source 
line. 
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Figure 5-1 

Example of MAC11 Line Printer Listing 
(132-column line printer) 



5©1®2 Page Headings 

The MAC11 Assembler outputs each page in the format shorn in Figure 
5-1 9 Line Printer Listing® On the first line of each listing page the 
Assembler prints (from right to left)i 

L title taken from .TITLE directive® 

2® assembler version identification 

3® page number® 

The second line of each listing page contains the subtitle text 
specified in the last encountered ©SBTTL directive® 


5®1® 3 aTITLE 

The ©TITLE directive is used to assign a name to the listing output® 
The name is the first symbol following the directive and must be six 
Radix-50 characters or less (any characters beyond the first six are 
ignored)® Non-Radix 50 characters are not acceptable® For examplei 

©TITLE PROG TO PERFORM DAILY ACCOUNTING 

causes the listing output ©f the assembled program to be named PROG 
(this name is distinguished from the filename of the binary output 
specified in the command string to the Assembler). 

If there is no ©TITLE statement , the default name assigned to the 
first listing output ie 

©MAIN® 

The first tab or space following the ©TITLE directive is not 
considered part of the listing output name or header text* although 
subsequent tabs and spaces are significant® 

If there is more than one ©TITLE directive* the last ®TITLE directive 
in the program conveys the name of the listing output© 


5®1® 4 ©SBTTL 

The @ SBTTL directive is used to provide the elements for a printed 
table of contents of the assembly listing© The text following the 
directive is printed as the second line of each of the following 
assembly listing pages until the next occurrence of a © SBTTL 
directive® For examples 

©SBTTL CONDITIONAL ASSEMBLIES 


The text 


CONDITIONAL ASSEMBLIES 

is printed as the second line of each of the following assembly 
listing pages® 
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During pass 1 of the assembly process^ MAC11 automatically prints a 
table of contents for the listing containing the line sequence number 
and text of each * SBTTL directive in the program,, 

An example of the table of contents is shown in Figure 5-2© Note that 
the first word of the subtitle heading • is not limited to six 
characters since it is not a module name® 


MACRO VIA 


MACRO VIA 
TABLE OF CONTENTS 


5 - 1 

7- 1 

12 - 1 
14- 1 

16 - 1 
26- 1 
36- 1 

40- 1 

41- 1 

48- 1 

50- 1 

51- 1 

59- 1 

68 - 1 
72- 1 

74- 1 

75- 1 

78- 1 

79- 1 

80- 1 
88 - 1 

92- 1 

93- 1 

99- 1 

103- 1 

109- 1 

114- 1 

116- 1 
135- 1 


SECTOR INITIALIZATION 
SUBROUTINE CALL DEFINITIONS 
PARAMETERS 
ROLL DEFINITIONS 
PROGRAM INITIALIZATION 
ASSEMBLER PROPER 
STATEMENT PROCESSOR 
ASSIGNMENT PROCESSOR 
OP CODE PROCESSOR 

EXPRESSION TO CODE-ROLL CONVERSIONS 

CODE ROLL STORAGE 

DIRECTIVES 

DATA-GENERATING DIRECTIVES 
CONDITIONALS 
LISTING CONTROL 
ENABL/DSABL FUNCTIONS 
CROSS REFERENCE HANDLERS 
LISTING STUFF 
KEPBOARD HANDLERS 
OBJECT CODE HANDLERS 
LISTING OUTPUT 
I/O BUFFERS 
EXPRESSION EVALUATOR 
TERM EVALUATOR 
SYMBOL/CHARACTER HANDLERS 
ROLL HANDLERS 
REGISTER STORAGE 
MACRO HANDLERS 
FIN 


Table of Contents text is taken from the text of each . SBTTL 
directive. The associated numbers are 'the page and line sequence 
numbers of the .SBTTL directive @ 


Figure 5-2 

Assembly Listing Table of Contents 
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5.1.5 Page Ejection 

There are several means of obtaining a page eject in a MACH assembly 
listings 

1 . After a line count of 58 lines, MACH automatically performs 
a page eject to skip over page perforations on line printer 
paper and to formulate terminal output into pages. 

2. A form feed character used as a line terminator (or as the 
only character on a line) causes a page eject. Used within a 
macro definition a form feed character causes a page eject. 
A page eject is not performed when the macro is invoked. 

3. More commonly, the .PAGE directive is used within the source 
code to perform a page eject at that point. The format of 
this directive is 

@ PAGE 

This directive takes no arguments and causes a skip to the 
top of the next page. 

Used within a macro definition, the .PAGE is ignored, but the 
page eject is performed at each invocation of that macro. 


5.2 FUNCTIONS! .ENABL AND .DSABL DIRECTIVES 

Several functions are provided by MACH through the .ENABL and .DSABL 
directives. These directives use 3-character symbolic arguments to 
designate the desired function, and are of the forms* 

.ENABL arg 
.DSABL arg 


where: 


arg is one of the legal symbolic arguments defined below. 

The following table describes the symbolic arguments and their 
associated functions in the MACH languages 


Symbolic 

Argument Function 


CDR The statement ©ENABL CDR causes source columns 73 and 

greater to be treated as comment© This accommodates 
sequence numb©rs in card columns 72-80® 

LC Enabling of this function causes the Assembler to 

accept lower case ASCII input instead of converting it 
to upper case© 

LSB Enable or disable a local symbol block© While a local 

symbol block is normally entered by encountering a new 
symbolic labels ©ENABL LSB forces a local symbol block 
which is not terminated until a label following the 
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©DSABL LSB statement is encountered© The default case 
XS © DSABL LSB© 

PNC The statement ©DSABL PNC inhibits binary output until 

an 0 ENML PNC is encountered© The default case is 
©ENABL PNC© 

An incorrect argument causes the directive containing it to be flagged 
as an error© 


5© 3 DATA STORAGE DIRECTIVES 

A wide range of data and data types can be generated with the 
following directives and assembly charactersi 

©BYTE 

©WORD 


©ASCII 
©ASCXZ 
©RAB50 
tB 
tD 

to 

These facilities are explained in the following Sections© 


5© 3©1 ©BYTE 

The ©BYTE directive is used to generate successive bytes of data© The 
directive is of the formi 

©BYTE exp IWHICH STORES THE OCTAL EQUIVALENT 

IOF THE EXPRESSION exp IN THE NEXT 
IBYTE * 

©BYTE expl*exp2 # ® © © IWHICH STORES THE OCTAL EQUIVALENTS 

IOF THE LIST OF EXPRESSIONS IN 
ISUCCESSIVE BYTES© 

where a legal expression must have an absolute value (or contain a 
reference to an external symbol) and must result in eight bits or less 
of data© The 16-bit value of the expression must have a high-order 
byte (which is truncated) that is either all zeros or all ones© Each 
operand expression is stored in a byt© of the object program© 
Multiple operands are separated by commas and stored in successive 
bytes© For examples 

SAM=5 

©=410 

©BYTE tD48*SAM f060 (OCTAL EQUIVALENT OF 48 DECIMAL) 

IIS STORED IN LOCATION 410* 005 IS 
I STORED IN LOCATION 411© 

If the high order byte of the expression equates to a value other than 

0 or -1* it is truncated to the low-order eight bits and flagged with 
a T error code© 



If an operand following the ©BYTE directive is null, it is interpreted 
as a zero® For examplei 

@—420 

@BYTE ,, $ ZEROES ARB STORED IN BYTES 420, 

421, AND 422 @ 


5.3*2 .WORD 

The ©WORD directive is used to generate successive words of data© The 
directive is of the forms 

.WORD exp iWHICH STORES THE OCTAL EQUIVALENT 

IOF THE EXPRESSION exp IN THE NEXT 
I WORD 

0 WORD expl,exp2 f o S@ IWHICH STORES THE OCTAL EQUIVALENTS 

I OF THE LIST OF EXPRESSIONS IN 
ISUCCESSIVE WORDS© 

where a legal expression must result in sixteen bits or less of data© 
Each operand expression is stored in a word of the object program© 
Multiple operands are separated by commas and stored in successive 
words. For examplei 

SAL-0 

@“500 

.WORD 177535, ©4*4, SAL f STORES 177535, 506 , AND 0 IN 

I WORDS 500, 502 , AND 504© 

If an expression equates to a value of more than sixteen bits, it is 
truncated and flagged with a T error code© 

If an operand following the ©WORD directive is null, it is interpreted 
as zero® For examples 

500 

Word ,5, iSTORES 0, 5, AND 0 IN LOCATIONS 500 

f502, AND 504© 

A blank operator field Cany operator not recognized as a macro call, 
op-code, directive or semicolon) is interpreted as an implicit ©WORD 
directive® Use of this convention is discouraged© The first term of 
the first expression in the operand field must not be an instruction 
mnemonic or assembler directive unless preceded by a *4* or - operator® 
For examplei 

.=440 I THE OP-CODE FOR MOV, WHICH IB 010000, 

LABEL1 +MOV,LABEL I IS STORED ON LOCATION 440© 

1440 IS STORED IN LOCATION 442© 

Note that the default ©WORD directive occurs whenever there is a 
leading arithmetic or logical operator, or whenever a leading symbol 
is encountered which is not recognized as a macro call, an instruction 
mnemonic or assembler directive© Therefore, If an instruction 



mnemonic 9 macro call or assembler directive is misspelled # the ©WORD 
directive is assumed and errors will result® Assume that MOV is 
spelled incorrectly as MORg 

MOJR A^B 

Two error codes resulti Q occurs because an expression operator is 
missing between MOR and A, and a U occurs if MOR is undefined @ Two 
words are then generatedi one for MOR A and one for B© 


5 S 3 @ 3 ASCII Conversion of One or Two Characters 

The § and 11 characters are used to generate text characters within the 
source text® A single apostrophe followed by a character results in a 
word in which the 7-bit ASCII representation of the character is 
placed in the low-order byte and zero is placed in the high-order 
byte o For example t 

MOV # 1 A f RO 

results in the following sixteen bits being moved into ROi 


15 


8 7 


101 


octal ASCII value of A 


The 0 character is never followed by a carriage return 9 null* rubout, 
line feed or form feed© (For another use of the f character 9 see 
Section 5 e 3©6@) 

STMNTi 


GETSYM 

BEQ 

4$ 



CMPB 

@CHRPNT,#' : 

|COLON 

DELIMITS LABEL FIELD. 

BEQ 

LABEL 



CMPB 

@CHRPNT,#'= 

I EQUAL 

DELIMITS 

BEQ 

AS GMT 

1 ASSIGNMENT PARAMETER© 


A double quote followed by two characters results in a word in which 
the 7-bit ASCII representations of the two characters are placed© For 
examplei 


MOV # f§ AB f RO 

results in the following word being moved into ROt 


15 


8 7 




102 


101 


octal ASCII value of B 


octal ASCII value of A 
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The " character is never followed by a carriage return , null, rubout , 
line feed or form feed. For examples 


; DEVICE NAME TABLE 


DEVNAMi 

©WORD 

"DF 

|HF DISK 


©WORD 

“DK 

1RK DISK 


©WORD 

"DP 

I HP DISK 

DEVNKBi 

©WORD 

"KB 

f TTY KEYBOARD 


©WORD ’ 

"DT 

iDECTAPE 


©WORD 

"LP 

ILIME PRINTER 


©WORD 

"PR 

!PAPER TAPE READER 


©WORD 

"PP 

1 PAPER TAPE PUNCH 


©WORD 

"CR 

fCARD READER 


©WORD 

"MT 

IMAGTAPE 


©WORD 

0 

ITABLE § S END 


5.3.4 .ASCII 

The .ASCII directive translates character strings into their 7-bit 
.ASCII equivalents for use in the source program. The format of the 
.ASCII directive is as follows s 

* .ASCII /character string/ 


wherei 


character 

string 


/ / 


As an example: 


is a string of any acceptable printing ASCII 
characters. The string may not include null 
(blank) characters , rubout, carriage return, 
line feed, vertical tab, or form feed. 

Nonprinting characters can be expressed in 
digits of the current radix and delimited by 
angle brackets. (Any legal, defined 
expression is allowed between angle 

brackets.) 

these are delimiting characters and may be 
any printing characters other than i < 
and = characters and any character within the 
string. 


A: .ASCII /HELLO/ 

.ASCII BC/<15X12>/DEF/ 
.ASCII /<AB>/ 


ISTORES ASCII REPRESENTATION OF THE 
I LETTERS H,E,L,L,0 IN CONSECUTIVE 
IBYTES. 

I STORES A,B,C,15,12,D,E,F IN 
% CONSECUTIVE BYTES. 

? STORES <,A,B,> IN CONSECUTIVE 
jBYTES. 


The i and = characters are not illegal delimiting characters, but are 
pre-empted by their significance as a comment indicator and assignment 
operator, respectively. For other than the first group, semicolons 
are treated as beginning a comment field. For example: 




Example 

ASCII string 
Generated 

Notes 

.ASCII 

;ABC;/DEF/ 

ABC 

DEF 

Acceptable, but not a recommended 
procedure® 

ASCII 

/ABC/;DEF; 

ABC 


fDEFf is treated as a comment and 
ignored® 

ASCII 

/ABC/=DEF= 

ABC 

DEF 

Acceptable, but not recommended 
procedure . 

ASCII 

=DEF= 



The assignment 





©ASCII—DEF 





is performed and a Q-error is 
generated upon encountering the 
second 


5.3.5 .ASCIZ 

The .ASCIZ directive is equivalent to the .ASCII directive with a zero 
byte automatically inserted as the final character of the string. For 
examplei 

When a list or text string has been created with a .ASCIZ 
directive, a search for the null character can determine the end 
of the list. For example: 


MOV #HELL0,R1 
MOV #LINBUF,R2 
Xi MOVE (Rl)+,(R2)+ 
BNE X 


HELLOs .ASCIZ <CRXLF>/MACll VlA/<CRXLF> ; INTRO MESSAGE 


5.3.6 .RAD50 

The .RAD50 directive allows the user the capability to handle symbols 
in Radix-50 coded form (this form is sometimes referred to as MOD40 
and is used in PDP-11 system programs). Radix-50 form allows three 
characters to be packed into sixteen bits; therefore, any 6—character 
symbol can be held in two words. The form of the directive is: 

„RAD50 /s tring/ 
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where 







/ / delimiters can b@ any printing characters 

other than the <, and $ characters® 

string is a list of the characters to be converted 

(three characters par word) and which may 
consist of the characters A through 0 

through 9 s dollar ($) f dot (©) and space ( )® 
If' there are fewer than three characters (or 
if the last set is fewer than three 
characters) they are considered to be 
left-Iustifled and trailing spaces are 

assumed® Illegal nonprinting characters are 
replaced with a 1 character and cause an 1 
error flag to be set® Illegal printing 
characters set the Q error flag© 


The trailing delimiter may be a carriage return § semicolon # or 
matching delimiter© For examplei 


• BAB50 /ABC 
©RAD50 fm/ 
©RAD50 // 

© RAD5Q /ABCD/ 


I PACK ABC INTO ONE WORD® 

I PACK AB (SPACE) INTO ONE WORD® 

I PACK 3 SPACES INTO ONE WORD© 

I PACK ABC INTO FIRST WORD AND 
fD SPACE SPACE INTO SECOND WORD© 


Each character is translated into 
in the following tables 

Character 

(space) 

A-Z 

$ 

0-9 


its Rad±x^50 equivalent as indicated 


Radix-30 Equivalent (octal) 
0 

1-32 

33 

34 

36-47 


Note that another character could be defined for code 35^ which is 

currently unused® 

The Radix-50 equivalents for characters 1 through 3 (Cl # C2^ C3) are 

combined as followsi 

Radix 50 value = ( (C1^50)-fC2) ^504»C3 

For examplei 

Radix-50 value of ABC is ( (1^50)+2)^50t3 or 3223 

See Appendix A for a table to quickly determine Radix-50 equivalents © 

Use of angle brackets is encouraged in the ©ASCII , ©ASCIZ^ and ©RAD50 
statements whenever leaving the text string to insert special codes© 
For example! 

©ASCII <X01> IEQUIVALENT TO ©ASCII/A/ 

0 RAD50 /AB/<35> ISTORES 3255 IN NEXT WORD 
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CHR1=1 

CHR2=2 

CHR3=3 


© 

©RADS 0 < CHR1> < CHR2 > <CHR3 > 


I EQUIVALENT TO ,RAD50/ABC/ 


5.4 RADIX CONTROL 


5.4.1 ®RADIX 

Numbers used in a MACXX source program are initially considered to be 
octal numbers® However t the programmer has the option of declaring 
the following radices! 

2 f 4, 8 s 10 

This is done via the ©RADIX directive , of the forms 
8 RADIX n 


wherei 


n is one of the acceptable radices® 

The argument to the ®RADIX directive is always Interpreted in decimal 
radix® Following any radix directive 9 that radix is the assumed base 
for any number specified until the following © RADIX directive® 

The default radix at the start of each program^ and the argument 
assumed if none Is specifled, Is 8 (octal). For examples 

© RADIX 10 |BEGINS SECTION OF CODE WITH DECIMAL RADIX 


e RADIX I REVERTS TO OCTAL RADIX 

In general^ it is recommended that macro definitions not contain nor 
rely on radix settings from the © RADIX directive. The temporary radix 
control characters should be used within a macro definition© (tD, to, 
and fB are described in the following Section®) A given radix is valid 
throughout a program until changed© Where a possible conflict exists 
within a macro definition or in possible future uses of that code 
module^ It is suggested that the user specify values using the 
temporary radix controls© 


5©4®2 Temporary Radix Controls tD f to, and tB 

Once the user has specified a radix for a section of code^ or has 
determined to use the default octal radix he may discover a number of 
cases where an alternate radix is more convenient (particularly within 
macro definitions)© For example, the creation of a mask word might 
best be done in the binary radix© 
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MACll has three unary operators to provide a single interpretation in 
a given radix within another radix as follows s 

tDx (x is treated as being in decimal radix) 

tOx (x is treated as being in octal radix) 

tBx (x is treated as being in binary radix) 

For examplei 

fD123 
tO 47 

tB 00001101 
tO<At3> 

Notice that while the up arrow and radix specification characters may 
not be separated , the radix operator can be physically separated from 
the number by spaces or tabs for formatting purposes© Where a term or 
expression is to be interpreted in another radix 9 it should be 
enclosed in angle brackets. 

These numeric quantities may be used any place where a numeric value 

is legal® 

PAL-HR contains a feature* which is maintained for compatibility in 
MACll* allowing a temporary radix change from octal to decimal by 
specifying a decimal radix number with a ^decimal pointFor examples 

100. (144(8)) 

1376. (2540 (8)) 

128. (200(8)) 


5.5 LOCATION COUNTER CONTROL 

The four directives which control movement of the location counter are 
.EVEN and ©ODD which move the counter a maximum of one byte* and ®BLKB 
and ®BLKW which allow the user to specify blocks of a given number of 
bytes or words to be skipped in the assembly. 


5® 5 a 1 ©EVEN 

The © EVEN directive ensures that the assembly location counter 
contains an even memory address by adding one if the current address 
is odd® If the assembly location counter is even* no action is taken© 
Any operands following a ©EVEN directive are ignored© 

The ©EVEN directive is used as follows § 

©ASCIZ /THIS IS A TEST/ 

©EVEN |ASSURES NEXT STATEMENT 

IBEGINS ON A WORD BOUNDARY© 


©WORD XYZ 
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5© 5 e 2 .ODD 


The • ODD directive ensures that the assembly location counter is odd 
by adding one if it is even* For examples 


I CODE TO MOVE DATA FROM AN INPUT LINE 
I TO A BUFFER 

N=5 I BUFFER HAS 5 WORDS 


.ODD 

©BYTE N^2 
BUFF s *BLKW N 


ICOUNT—2N BYTES 
I RESERVE BUFFER OF N WORDS 


MOV 

MOV 

MOVB 

AGAIN s MOVB 
BEQ 
DEC 
BNE 


#BUFF # R2 
#LXNE # Rl 
1(R2),R0 
(Rl) 4- f (R2) 4- 
DONE 
RO 

AGAIN 


IADDRESS OF EMPTY BUFFER IN R2 
IADDRESS OF INPUT LINE IS IN Rl 
IGET COUNT STORED IN BUFF-1 IN RO 
IMOVE BYTE FROM LINE INTO BUFFER 
IWAS NULL CHARACTER SEEN? 

I DECREMENT COUNT 
INOT = 0, GET NEXT CHARACTER 


CLRB —(R2) 

DONEs 


I OUT OF ROOM IN BUFFER # CLEAR LAST 
| WORD 


LINEi ®ASCIZ /TEXT/ 

In this case # • ODD is used to place the buffer byte count in the byte 
preceding the buffer^ as followsi 

COUNT BUFF-2 


BUFF 
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5 8 5 e 3 oBLKB and ©BLKW 

Blocks of storage can be reserved using the ©BLKB and ©BLKW 
directives. e BLKB is used to reserve byte blocks and ©BLKW reserves 
word blocks® The two directives are of the forms 

e BLKB exp 

^ BLKW exp 

where? 

exp is the number of bytes or words to reserve® If no 
argument is present 9 1 is the assumed default value© 

Any legal expression which is completely defined at 
assembly time and produces an absolute number is legal® 


For examplei 




1 000000 

PASS % .BLKW 



2 



?NEXT GROUP MUST STAY TOGETHER 

3 000002 

SYMBOLS ®BLKW 

2 

;SYMBOL ACCUMULATOR 

4 000006 

MODES 



5 000006 

FLAGS'! ©BLKB 

1 

!FLAG BITS 

6 000007 

SECTOR! ®BLKB 

1 

1 SYMBOL/EXPRESSIONS TYPE 

7 000010 

VALUE s .BLKW 

1 

;EXPRESSION VALUE 

8 00012 

RELLVLs ©BLKW 

1 


9 

©BLKW 

2 

?END OF GROUPED DATA 

10 




11 00020 

CLCNAMs ©BLKW 

2 

1CURRENT LOCATION COUNTER SYMBOL 

12 00024 

CLCFGSs ©BLKB 

1 


13 00025 

CLCSECi ©BLKB 

1 


14 00026 

CLCLOC % ©BLKW 

1 


15 00030 

CLCMAXi ©BLKW 

1 


The .BLKB directive has the same < 

effect as 


s — • 4*exp 

but is easier to interpret in the context of source code® 


5®6 TERMINATING DIRECTIVES 


5 ® 6 0 1 ©END 

The S END directive indicates the physical end of the source program® 
The ©END directive is of the forms 


• END exp 


where: 


exp is an optional argument which 9 if present^ indicates 
the program entry pointy i®e®^ the transfer address® 
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At the conclusion of the first assembly pass, upon encountering the 
END statement , MACH prints t 

END OF PASS 1 

and attempts to reread the source file(s) to perform pass 2, If the 
source file is on a disk, DECtape, or magtape device no further 
operator action is necessary. If the source file is on paper tape an 
TOPS 4 message is printed| the user is expected to reposition the 
tape in the reader and type tR (for CONTINUE)* 


5® 7 CONDITIONAL ASSEMBLY DIRECTIVES 

Conditional assembly directives provide the programmer with the 
capability to conditionally include or ignore blocks of source code in 
the assembly process. This technique is used extensively to allow 
several variations of a program to be generated from the source 
program® 

The general form of a conditional block is as followss 

•IF cond,argument(s) ;START CONDITIONAL BLOCK 

I RANGE OF CONDITIONAL 
IBLOCK 

|END CONDITIONAL BLOCK 


is a condition which must be met if the block 
is to be included in the assembly„ These 
conditions are defined below• 

are a function of the condition to be tested® 

is the body of code which is included in the 
assembly or ignored depending upon whether 
the condition was met® 

The following are the allowable conditionss 


wheres 


,ENDC 


cond 


argument(s) 
range 


Conditions 


POSITIVE 

COMPLEMENT 

ARGUMENTS 

ASSEMBLE BLOCK IF 

EQ 

NE 

expression 

expression-0 (or =0) 

GT 

LE 

expression 

expression>0 (or <0) 

LT 

GE 

expression 

@xpr@ssion<0 (or >0) 

DF 

NDF 

symbolic argument 

symbol is defined (or 
undefined) 

B 

NB 

macro-type argument 

argument is a blank (or 
not blank) 
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DIF two macro-type arguments identical 

arguments separated (or different) 
by a comma 

NZ. expression same as EQ/NE 

L expression same as GT/LE 


NOTE 

A macro-type argument Is enclosed in 
angle brackets or within an up-arrow 
construction (as described in Section 
6©3®1)© For examples 

<AjrB # C-> 

f/124/ 

For examples 

«IF EQ ALPHA4-1 I ASSEMBLE IF ALPHAS 1«0 

© 

© 

©ENDC 

Within the conditions DF and NDF the following two operators are 
allowed to group symbolic arguments? 

& logical AND operator 
1 logical inclusive OR operator 

For example? 

© IF DF SYMl & SYM2 


IDN 

Z 

G 


©ENDC 

assembles if both SYMl and SYM2 are defined© 


5 © 7 © 1 Subconditionals 

Subconditionals may be placed within conditional blocks to indicatei 

1© assembly of an alternate body of code when the condition of 
the block indicates that the code within the block is not to 
be assembled® 

2® assembly of a non-contiguous body of code within the 
conditional block depending upon the result of the 
conditional test to enter the block© 

3© unconditional assembly of a body of code within a conditional 
block© 



There are three subconditional directives , as follows 


Subconditional 

Function 

9 IFF 

The code following thi sstatement up to the next 
subconditional or end of the conditional block is 
included in the program providing the value of the 
condition tested upon entering the conditional 
block was false® 

• IFT 

The code following this statement up to ‘the next 
subconditional or end of the conditional block is 
included in the program providing the value of the 
condition tested upon entering the conditional 

block was true® 

® IFTF 

The code following "this statement up to the next 
subconditional or the end of the conditional block 
is included in the program regardless of the value 
of the condition tested upon entering the 
conditional block®. 


The implied argument of the subconditionals is the value of the 
condition upon entering the conditional block®- Subconditionals are 
used within outer level conditional blocks® Subconditionals are 
ignored within nested^ unsatisfied condition blocks. For example! 


® IF DF SYM 

1ASSEMBLE BLOCK IF SYM ! 

IS DEFINED 


@ IFF 





© 

!ASSEMBLE THE FOLLOWING 

CODE 

ONLY 

IF 

© 

fSYM IS UNDEFINED® 




1 IFT 

1ASSEMBLE THE FOLLOWING 

CODE 

ONLY 

IF 

a 

© 

1SYM IS DEFINED® 




s 

a IFTF 

1ASSEMBLE THE FOLLOWING 

CODE 



9 

© 

1UNCONDITIONALLY. 




© 

.ENDC 






©IF DF X 

?ASSEMBLY TESTS FALSE 

©IF DF Y 

ITESTS FALSE 

©IFF 

INESTED CONDITIONAL 

© 

© 

1IGNORED 

© IFT 

0 

j NOT SEEN 

& 

o 

©ENDC 
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However , 


©IF DF 

X 

;TESTS TRUE 

• IF DF 

Y 

1 TESTS FALSE 

@ IFF 

© 


|XS ASSEMBLED 

© 

© XFT 

© 


f NOT ASSEMBLED 

.ENDC 




5 ® 7 ® 2 Immediate Conditionals 

An immediate conditional directive is a means of writing a 1-line 
conditional block® In this form^ no ©ENDC statement is required and 
the condition is completely expressed on the line containing the 
conditional directive® Immediate conditions are of the forms 

a IXF cond^ arg f statement 


wherei 


cond 

Is one of the legal conditions defined for 
conditional blocks in Section 5®7® 

arg 

is the argument associated with the condition 
specified; that is # either an expression f 
symbol # or macro-type argument^ ae described 


in Section 5 @ 7© 

statement 

is the statement to be executed if the 
condition is met® 


For examples 

© ZXF DF FOO^BEQ ALPHA 

this statement generates the code 
BEQ ALPHA 

if the symbol F00 is defined® 

A label must not be placed in the label field of the «XXF statement® 
Any necessary labels may be placed on the previous lines 

LABELi 

© XXF DF FPP,BEQ f ALPHA 

or included as part of the conditional statementi 
9 XXF DF FOO^LABEL! BEQ ALPHA 
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5 @ 7«3 PAL-11R Conditional Assembly Directives 

In order to maintain compatibility with programs developed under 
PAL-HR* the following conditionals remain permissible under MACRO-11© 
It is advisable that further programs be developed using the format 
for MACRO-11 conditional assembly directives© 


Directive 

Arguments 

Assemble Block if 

e XFZ or ©IFEQ 
©IFN2 or ©IFNE 
@IFL or ©IFLT 
©IFG or •IFGT 
© IFLE 
@ IFGE 
• IFDF 
o IFNDF 

expression 
expression 
expression 
expression 
expression 
expression 
logical expression 
logical expression 

expression-0 
expression^ 
expression<0 
expression>0 
@xpression< or «0 
expression> or -0 
expression is true (defined) 
expression is false 
(undefined) 


The rules governing the usage of these directives are now the same as 
for the MACRO-11 conditional assembly directives previously 
described© Conditional assembly blocks must end with the ©ENDC 
directive and are limited to a nesting depth of 16(10) levels 
(instead of the 127(10) levels allowed under PAL-11R)• 
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CHAPTER 6 


MACRO DIRECTIVES 


6©1 MACRO DEFINITION 

It is often convenient in assembly language programing to generate a 
recurring coding sequence with a single statement® In order to do 
th±s # the desired coding sequence is first defined with dummy 
arguments as a macro® Once a macro has been defined, a single 
statement calling the macro by name with a list of real arguments 
(replacing the corresponding dummy arguments in the definition) 
generates the correct sequence or expansion® 


6®1®1 ©MACRO 

The first statement of a macro definition must be a ©MACRO directive© 
The •MACRO directive is of the formi 

• MACRO nam@ f dummy argument list 


where s 


name is the name of the macro® This name is any legal 

symbol* The name chosen may be used as a label 
elsewhere in the program© 

, represents any legal separator (generally, a coma 

os’ space) © 


dummy zero^ one, or more legal symbols which may appear 
argument anywhere in the body of the macro definition, even 
list as a label® These symbols can be used elsewhere 

in the user program with no conflicts of 
definition* Where more than one dummy argument is 
used f they are separated by any legal separator 
(generally a comma) © 


A comment may follow the dummy argument list in a statement containing 
a ®MACRO directive® For examples 


©MACRO ABS A^B |DEFINE MACRO ABS WITH WO ARGUMENTS 


A label must not appear on a ©MACRO statement© Labels are sometimes 
used on macro calls, but serve no function when attached to ©MACRO 
statements© 
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6.1.2 .ENDM 


The final statement of every macro definition must be an .ENDM 
directive of the form? 

.ENDM name 


wherei 


name is an optional argument , being the name of the macro 
terminated by the statement. 


For example: 


.ENDM (terminates the current macro definition) 

.ENDM ABS (terminates the definition of the macro ABS) 

If specified, the symbolic name in the .ENDM statement must correspond 
to that in the matching .MACRO statement. Otherwise, the statement is 
flagged and processing continues. Specification of the macro name in 
the .ENDM statement permits the Assembler to detect missing .ENDM 
statements or improperly nested macro definitions. 

The .ENDM statement may contain a comment field, but must not contain 
a label. 

An example of a macro definition is shown below: 

.MACRO TYPMSG MESSGE jTYPE A MESSAGE 
JSR R5,TYPMSG 
.WORD MESSGE 
.ENDM 


6.1.3 .MEXIT 

In order to implement alternate exit points from a macro (particularly 
nested macros), the .MEXIT directive is provided. .MEXIT terminates 
the current macro as though an .ENDM directive were encountered. use 
of .MEXIT bypasses the complications of conditional nesting and 
alternate paths. For example: 

.MACRO ALTR N,A,B 


@ 

.IF EQ,N 


ISTART CONDITIONAL BLOCK 


.MEXIT IEXIT FROM MACRO DURING CONDITIONAL BLOCK 

.ENDC ?END CONDITIONAL BLOCK 


♦ENDM )NORMAL END OF MACRO 

In an assembly where N=0, the .MEXIT directive terminates the macro 
expansirru 
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Where macros are nested, a .MEXIT causes an exit to the next higher 
level. A .MEXIT encountered outside a macro definition is flagged as 
an error. 


6.1.4 MACRO Definition Formatting 

A form feed character used as a line terminator on a MACH source 
statement (or as the only character on a line) causes a page eject. 
Used within a macro definition, a form feed character causes a page 
eject. A page eject is not performed when the macro is invoked. 

Used within a macro definition, the .PAGE directive is ignored, but a 
page eject is performed at invocation of that macro. 






6.2 MACRO CALLS 

A macro must be defined prior to its first reference. Macro calls are 
of the general forms 

labels name, real arguments 


wherei 


label 

name 


real 

arguments 


represents an optional statement label. 

represents the name of the macro specified in 
the .MACRO directive preceding the macro 
definition. 

are those symbols, expressions, and values 
which replace the dummy arguments in the 
.MACRO statement. Where more than one 
argument is used, they are separated by any 
legal separator. 


Where a macro name is the same as a user label, the appearance of the 
symbol in the operation field designates a macro call, and the 
occurrence of the symbol in the operand field designates a label 
reference. For example: 

ABS: MOV @R0,R1 ?ABS IS USED AS A LABEL 



BR ABS 


f ABS IS CONSIDERED A LABEL 


© 

ABS #4 f ENT ^ LAB, I CALL MACRO ABS WITH 3 ARGUMENTS 

Arguments to the macro call are treated as character strings whose 
usage is determined by the macro definition© 
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6® 3 ARGUMENTS TO MACRO CALLS AND DEFINITIONS 

Arguments within a macro definition or macro call are separated from 
other arguments by any of the separating characters described in 
Section 3®1©X® For examplei 

.MACRO REN A^B^C 


REN ALPHA,BETA,<C1,C2> 

Arguments which contain separating characters are enclosed in paired 
angle brackets © An up-arrow construction is provided to allow angle 
brackets to be passed as arguments® Bracketed arguments are seldom 
used in a macro definition^ but are more likely in a macro call© For 
examplei 

REN <MOV X r Y>#44,WEV 

This call would cause the entire statementt 
MOV X^Y 

to replace all occurrences of the symbol A in the macro definition® 
Real arguments within a macro call are considered to be character 
strings and are treated as a single entity until their use in the 
macro expansion© 

The up^arrow construction could have been used in the above macro call 
as followsi 

REN t/MOV X$Y /$#44 f WEV 
which is equivalent to 

REN <MOV X f Y> 9 #44 f WEV 

Since spaces are ignored preceding an argument, they can be used to 
increase legibility of bracketed constructions© The forms 

REN #44 ^WEVt/MOV X ff Y/ 

however^ contains only two argumentss #44 and WEY t/MOV X f Y/ (see 
Section 3®1®1) because t is a unary operator® 


6*3*1 Macro Nesting 

Macro nesting (nested macro calls) , where the expansion of one macro 
includes a call to another macro 9 causes one set of angle brackets to 
be removed from an argument with each nesting level© The depth of 
nesting allowed is dependent upon the amount of core space used by the 
program® To pass an argument containing legal argument delimiters to 
nested macros, the argument should be enclosed in one set of angle 
brackets for each level of nesting 9 as shown below© 

©MACRO LEVEL1 DUM1*DUM2 
LEVEL2 DUM1 
LEVELS DUM2 
©ENDM 



.MACRO LEVEL2 DUM3 
DUM3 

ADD #10,RO 
MOV R0 , (Rl)+ 

.ENDM 

A call to the LEVELl macros 

LEVELl <<MOV X,R0 >>,<<CLR R0>> 

causes the following expansions 

MOV X,R0 
ADD #10,R0 
MOV R0, (Rl) + 

CLR R0 

• ADD #10,R0 

MOV R0,(Rl)+ 

where macro definitions are nested (that is, a macro definition is 
entirely contained within the definition of another macro) the inner 
definition is not defined as a callable macro until the outer macro 
has been called and expanded. For examples 

.MACRO LVX A,B 


.MACRO LV2 A 



.ENDM 

.ENDM 

The LV2 macro cannot be called by name until after the first call to 
the LV1 macro. Likewise, any macro defined within the LV2 macro 
definition cannot be referenced directly until LV2 has been called. 


6.3.2 Special Characters 

Arguments may include special characters without enclosing the 
argument in a bracket construction if that argument does not contain 
spaces^ tabs, semi-colons j? or commas® For ©scampi© g 

*MACRO PUSH ARG 
MOV ARG^-(SP) 

@RNDM 


PUSH X-§"3{%2) 

generates the following codei 
MOV X+3(%2)(SP) 
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6®3®3 Numeric Arguments Passed as Symbols 

When passing macro arguments , a useful capability is to pass a symbol 
which can be treated by the macro as a numeric string® An argument 
preceded by the unary operator backslash (\) -is treated as a number in 
the current radix® The ASCII characters representing the number are 
inserted in the macro expansioni their functions are defined in 
context® For examplei 


B—0 

• MACRO INC A # B 
CNT A f \B 

©ENDM 

©MACRO CNT A f B 

A f B i ©WORD /SEE SEC®6©3©6 FOR EXPLANATION OF 

©ENOM 


INC X # C 


The macro call would expand toi 
XOi ©WORD 

A subsequent identical call t© the same macro would generatei 


XIi ©WORD 

and so on for later calls© The two macros are necessary because the 
dummy value of B cannot be updated in the CNT macro® In the CNT 
macro # the number passed is treated as a string argument® (Where the 
value of the real argument is a single 0 character is passed to the 
macro expansion©) 

The number being passed can also be used to make source listings 
somewhat clearer© For example, versions of programs created through 

conditional assembly of a single source can identify themselves as 
follows 1 


©MACRO IDT SYM 
©ASCII /SYM/ 
©ENDM 

© MACRO OUT ARG 
IDT 005A § ARG 
©ENDM 


I ASSUME THAT THE SYMBOL ID TAKES 
ION A UNIQUE TWO DIGIT VALUE FOR 
IEACH POSSIBLE CONDITIONAL ASSEMBLY 
I OF THE PROGRAM 


© | WHERE 0O5A IS THE UPDATE 

© IVERSION OF THE PROGRAM 

OUT \ID I AND ARG INDICATES THE 

ICONDITIONAL ASSEMBLY VERSION© 


The above macro call expands tog 
©ASCII /005AXX/ 

where XX is the conditional value of ID© 


Two macros are necessary since the text delimiting characters in the 
©ASCII statement would inhibit the concatenation of a dummy argument© 


6-6 



6.3.4 Number of Arguments 


If more arguments appear in the macro call than in the macro 
definition, the excess arguments are ignored® If fewer arguments 
appear in the macro call than in the definition, missing arguments are 
assumed to be null (consist of no characters). The conditional 
directives .IFB and .IFNB can be used within the macro to detect 
unnecessary arguments. 

A macro can be defined with no arguments. 


6.3.5 Automatically Created Symbols 

MAC11 can be made to create symbols of the form n$ where n is a 
decimal integer number such that 64<n<127. Created symbols are always 
local symbols between 64$ and 127$. (For a description of local 
symbols, see Section 3.5.) Such local symbols are created by the 
Assembler in numerical order % i.e.t 

64$ , 

65$ 


126$ 

127$ 

Created symbols are particularly useful where a label is required in 
the expanded macro. Such a label must otherwise be explicitly stated 
as an argument with each macro call or the same label is generated 
with each expansion (resulting in a multiply-defined label). Unless a 
label is referenced from outside the macro, there is no reason for the 
programmer to be concerned with that label. 

The range of these local symbols extends between two explicit labels. 
Each new explicit label causes a new local symbol block to be 
initialized. 

The macro processor creates a local symbol on each call of a macro 
whose definition contains a dummy argument preceded by 
the ? character. For examples 

.MACRO ALPHA A,?B 
TST A 
BEQ B 
ADD #5,A 

B I 

©EHBM 

Local symbols are generated only where the real argument of the macro 
call is either null or missing© If a real argument is specified in 
the macro call, the generation of a local symbol is inhibited and 
normal replacement is performed® Consider the following expansions ©f 
the macro ALPHA above® 



GENERATE A LOCAL SYMBOL FOR MISSING ARGUMENT; 


ALPHA %1 
TST %1 
BEQ 64$ 

ADD #5,%1 

64$ i 


DO NOT CREATE A LOCAL SYMBOL s 


ALPHA %2,XYZ 
TST %2 
BEQ XYZ 
ADD #5,%2 

XYZ i 


These Assembler-generated symbols are restricted to the first sixteen 
(decimal) arguments of a macro definition,, 


6.3.6 concatenation 

The apostrophe or single quote character ( 9 ) operates as a legal 
separating character in macro definitions„ An ' character which 
precedes and/or follows a dummy argument in a macro definition is 
removed and the substitution of the real argument occurs at that 
point. For example: 

.MACRO DEF A,B,C 
A’B: .ASCIZ /C/ 

.WORD 9 s A*'*B 
.ENDM 

When this macro is called: 

DEF X,Y,<MAC11> 

it expands as follows: 

XYs .ASCIZ /MAC11/ 

.WORD *X*Y 

In the macro definition, the scan terminates upon finding the 

first 9 character. Since A is a dummy argument, the * is removed. 
The scan resumes with B, notes B as another dummy argument and 

concatenates the two dummy arguments. The third dummy argument is 
noted as going into the operand of the .ASCIZ directive. On the next 
line (this example is purely for illustrative purposes) the argument 
to .WORD is seen as follows: The scan begins with a 9 character. 

Since it is neither preceded nor followed by a dummy argument, 
the 9 character remains in the macro definition. The scan then 

encounters the second • character which is followed by a dummy 
argument and is discarded. The scan of the argument A terminated upon 
encountering the second 9 which is also discarded since it follows a 
dummy argument. The next * character is neither preceded nor followed 
by a dummy argument and remains in the macro expansion. The 



last § character is followed by another dummy argument and is 
discarded. (Note that the five 1 characters were necessary to 
generate two 1 characters in the macro expansion®) 

Within nested macro definitions f multiple single quotes can be used^ 
with one quote removed at each level of -macro nesting® 


6 ® 4 s NARGjp ©NCER, MID «NTYPE 

These three directives allow the user to obtain the number of 
arguments in a macro call (®NARG) f the number of characters in an 
argument (©NCHR), or the addressing mode of an argument {©NTYPE)• Use 
of these directives permits selective modifications of a macro 
depending upon the nature of the arguments passed® 

The ©NARG directive enables the macro being expanded to determine the 
number of arguments supplied in the macro call, and is of the forms 

labels ©NARG symbol 

wherei 


label is an optional statement label 

symbol is any legal symbol whose value is equated to the 
number of arguments in the macro call currently 
being expanded® The symbol can be used by itself or 
in expressions® 

This directive can occur only within a macro definition© 

The ©NCHR directive enables a program to determine the number of 

characters in a character string, and is of the forms 

labels ©NCHR symbol, <character string> 

wherei 


labed 


is an optional statement label, 


symbol 


<character 
string> 


is any legal symbol which is equated to the 
number of characters ±n the specified character 
string© The symbol is separated from the 
character string argument by any legal 
separator® 

is a string of printing characters which should 
only be enclosed in angle brackets if it 
contains a legal separator© A semi-colon also 
terminates the character string® 


This directive can occur anywhere in a MACH program® 

The ®NTYPE directive enables the macro being expanded to determine the 
addressing mode of any argument, and is of the forms 


labels ©NTYPE 


symbol, arg 
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wherei 


label is an optional statement label * 

symbol is any legal symbol f the low-order 6-bits of which 
are equated to the 6-bit addressing mode of the 
argument® The symbol is separated from the argument 
by a legal separator® This symbol can be used by 
itself or in expressions® 

arg is any legal macro argument (dummy argument) as 
defined in Section 6®3® 

Thi s directive can occur only within a macro definition® to example 
of *NTYPE usage in a macro definition is shown belows 

ft MACRO SAVE 
ftNTYPE SYM^ARG 
© IF EQ,5YM&70 

MOV ARG # TEMP 

«IFF 

MOV SARG^TEMP 

ftENDC 
ftBNDM 


6 © 5 ft ERROR and . PRINT 

The ©ERROR directive is used to output messages to the command output 
device during assembly pass 2© A common use is to provide diagnostic 
announcements of a rejected or erroneous macro call® The form of the 
©ERROR directive is as followss 

labels @ERROR exprftext 

wherei 

label is an optional statement label® 

expr is an optional legal expression whose value is 

output to the command device when the © ERROR 
directive is encountered© Where expr is not 
specified 9 the text only is output to the command 
device© 

l denotes the beginning of the text string to be 

output© 

text is the string to be output to the command device© 

The text string is terminated by a line 
terminator. 

Upon encountering a © ERROR directive anywhere in a MACH program f the 
Assembler outputs a single line containingi 

1® the sequence number of the ©ERROR directive line f 
2© the current value of the location counter 9 
3 * the value of the expression if one is specified , and 
4© the text string specified s 


ARG 

I REGISTER MODE 
I NON- REGISTER MODE 


6-10 




For example 


© ERROR A|UNACCEPTABLE MACRO ARGUMENT 

causes a line similar to the following to be outputi 

512 5642 000076 fUNACCEPTABLE MACRO ARGUMENT 

This message is being used to indicate an inability of the subject 
macro to cope with the argument A which is detected as being indexed 
deferred addressing mode (mode 70) with the stack pointer (%6) used as 
the index register© 

The line is flagged on the assembly listing with a P error code© 

The ®PRINT directive is identical to ©ERROR except that it is not 
flagged with a P error code© 


6© 6 INDEFINITE REPEAT BLOCKI © IBP AND ©XRPC 

An indefinite repeat block is a structure very similar to a macro 
definition© An indefinite repeat is essentially a macro definition 
which has only one dummy argument and is expanded once for every real 
argument supplied© An indefinite repeat block is coded In-line with 
its expansion rather than being referenced by name as a macro Is 
referenced© An indefinite repeat block is of the forms 

labels ©IRP arg # <reaX arguments) 


(range of the indefinite repeat) 


© RNDM 


wherei 


label 


arg 


<r@al argument) 


range 


la an optional statement label® A label may 
not appear on any ®XRP statement within 
another macro definition # repeat range or 
indefinite repeat range 9 or on any ©BMDM 
statement© 

is a dummy argument which is successively 
replaced with the real arguments in the ©IRP 
statement® 

is a list of arguments to be used In the 
expansion of the Indefinite repeat range and 
enclosed In angle brackets, Each real 
argument is a string of zero or more 
characters or a list of real arguments 
(enclosed in angle brackets)© The real 
arguments are separated by commas© 

Is the block of code to be repeated once for 
each real argument in the list© The range 



may contain macro definitions 9 repeat ranges^ 
or other indefinite repeat ranges © Note that 
only created symbols should be used as labels 
within an indefinite repeat range® 

An indefinite repeat block can occur either within or outside macro 
definitions^ repeat rangesj? or indefinite repeat ranges® The rules 
for creating an indefinite repeat block are the same as for the 
creation of a macro definition (for example^ the ©MEX1T statement is 
allowed in an indefinite repeat block)© Indefinite repeat arguments 
follow the same rules as macro arguments® 
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1 

2 


3 

4 

5 

6 
7 
3 
9 


oTITLE IRPTST 
.LIST MD,MC*ME 

000000 R0»% 00 
000001 Rl=% 01 
000002 R2»% 02 
000003 R3=% 03 
000004 R4=% 04 
000005 R5=% 05 
000006 R6=% 06 
000007 R7—% 07 
000006 SP=% 06 
000007 PC=% 07 
177776 PSW= 0177776 
177570 SWR— 0177570 


000000 012/00 
000050 

MOV 

#TABLE , R0 


& IRP 

X,<A,B,C,D,E,F> 


MOV 

X, (RO) + 


© ENDM 




00004 

016720 

000032 

MOV 

A,(RQ)+ 


00010 

016720 

000030 

MOV 

B # (R0)+ 


00014 

016720 

000026 

MOV 

C„ (RO)+ 


00020 

016720 

000024 

MOV 

D*(RO)+ 


00024 

016720 

000022 

MOV 

B <, (RO) + 

12 

13 

14 

15 

16 
17 

00030 

016720 

000020 

MOV 

© IRPC 

«ASCII 

®EMBM 

F t ( RO ) + 

X^ABCDEF 

/X/ 


00034 

101 

©ASCII 

/A/ 


00035 

102 

©ASCII 

/B/ 


00036 

103 

©ASCII 

/c/ 


00037 

104 

©ASCII 

/D/ 
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00040 

105 


® ASCII 

/E/ 


00041 

106 


©ASCII 

/F/ 

18 






19 






20 

00042 

041101 

At 

©WORD 

"&B 

21 

00044 

041502 

Bi 

©WORD 

"BC 

22 

00046 

042103 

Cl 

©WORD 

"CD 

23 

00050 

042504 

Dl 

©WORD 

"DE 

24 

00052 

043105 

El 

©WORD 

"EF 

25 

00054 

043506 

Fi 

©WORD 

"FG 

26 

00056 


TABLEi 

©BLKW 

6 

27 






28 


000001 


©END 



Figure 6-1 

. IRP and .IRPC Example 


A second type of indefinite repeat block is available which handles 
character substitution rather than argument substitution. The ,IRPC 
directive is used as follows s 

label: .IRPC arg,string 


(range of indefinite repeat) 


.ENDM 

On each iteration of the indefinite repeat range , the dummy argument 
(arg) assumes the value of each successive character in the string. 
Terminators for the string ares space. feah, carriage return, 
line feed, and semi-colon. 


6.7 REPEAT BLOCK: .REPT 

Occasionally it is useful to duplicate a block of code a number of 
times in-line with other source code. This is performed by creating a 
repeat block of the form; 

label: .REPT expr 


(range of repeat block) 


.ENDM IOR .ENDR 
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wherei 


label is an optional statement label® The ©ENBR or ©ENDM 
directive may not have a label© A •REFT^statement 
occurring within another repeat blocks indefinite 
repeat blocks or macro definition may not have a 
label associated with it© 

expr is any legal expression controlling the number of 

times the block of code is assembled© Where @xpr<0 # 
the range of the repeat block is not assembled© 

range is the block of code to be repeated expr number of 

times © The range may contain macro definitions^ 
indefinite repeat ranges, or other repeat ranges© 
Note that no statements within a repeat range can 
have a label© 

The last statement in a repeat block can be an ©ENDM ^or ©ENDR 
statement© The ©ENDR statement is provided for compatibility with 
previous assemblers © 

The ©MEX1T statement is also legal within the rang© of a repeat block© 






OPERATING PROCEDURES 


This part of the manual describes the 
operation of the MACXX Assembler f its 
input files and their formats^ and the 
variations of the command string to the 
Assembler© 




CHAPTER 7 


OPERATING PROCEDURES 


This MAC11 Assembler assembles one ASCII source file containing MAC1X 
statements at a time into a single absolute binary output file® The 
output of the Assembler consists of an absolute binary file on a paper 
tap@ r and an assembly listing followed by the symbol table listing on 
the device assigned to •DAT-12® 


7® 1 LOADING MACH 

MACH is loaded under DOS-15 by typing i 

$MAC11 (followed by a carriage return or altmode) 

(Characters printed by the system are underlined to differentiate them 
from characters printed by the user® The Assembler responds by 
identifying itself and its version number^ followed by a > character 
to indicate readiness to accept a command input stringt 

MACRO VIA 

> 


7*2 COMMAND INPUT STRING 

In response to the > printed by the Assembler , the user types the 
switch options followed by the input filename; the switch options and 
the filename are separated by a . Command input can be terminated 
by a carriage return to restart MAG11, or by an altmode to return to 
DOS- 9 15 at the end of assembly i 

>SW«-FILNAM 


wherei 


SW is the switch option(s); can be null (for plain 

assembly^) or @ B f (for binary output) or (for 

listing) or both® 

FILNAM is the input filename extension or filename from 
®DAT—11© Default extension is § SRC @ ® The filename 
can consist of up to six characters followed by a 



space(s) and not more than a 3-character extension 
(additional characters cause the message 'NAME 
ERROR/TOO LONG 9 to be printed on the command inp3t 
device). All of the legal printing characters can be 
used in any order. The first non-space character to 
be typed after the first left-arrow (*-) is 
recognized as the first character of the filename. 
Similarly, the first non-space character after the 
filename (other than carriage return or altmode) is 
recognized as the first character of the extension. 


Examples: 

>*-FILNAM plain assembly of a file called 

’filnam SRC, and restart MAC11 

>*-FILNAM EXT plain assembly of a file called 'FILNAM EXT', 

and restart MACH. 

>B«-FILNAM EXT (ALT) assemble 'FILNAM EXT' to obtain an absolute 

binary output on a paper tape and return to 
DOS-15 monitor. 

>L«-FILNAM EXT (ALT) assemble 'FILNAM EXT’ to obtain a listing 

output on .DAT-12 and return to DOS-15 
monitor. 

>LB*-X1Y2 EO assemble 'X1Y2 EO to obtain an absolute 

binary output on a paper tape and a listing 
output on .DAT-12 and restart MACH. 

If an error is made in typing the command string, typing the RUBOUT 
key erases the immediately-preceding character. Repeated typing of 
the RUBOUT key erases one character for each RUBOUT up to the 
beginning of the line. Typing CTRL/U erases the entire line. 

A syntactical error detected in the command string causes _ the 
Assembler to print a ? character. The Assembler then reprints 
the > character and waits for a new command string to be entered. If 
the input file is not found or name and/or extension is illegal, the 
messages 


NAME ERROR/TOO LONG 
is printed. 


7-2 



MACRO V301 
OBJECT CODE HANDLERS 


MACRO V000A1 


1 




, SBTTL 

OBJECT CODE HANDLERS 

2 

3 

012026 


ENDPJ 



1 END OF PASS HANDLER 

4 

012026 



CALL 

setmax 



012026 

004767 

174240 


JSR 

PCjSETMAC 


5 

012062 

305767 
300000 1 


TST 

PASS 

J PASS ONE? 

a 

012036 

001142 


BNE 

ENDP2 

1 BRANCH IF PASS 2 

7 

012040 




ENTOVR 

4 

8 

012040 

005767 
001416' 


TST 

08JLNK 

IPASS ONEi ANY OBJECT? 

9 

012044 

001517 


BEq 

30S 

2 NO 

10 

12046 

312767 

000001 

000542' 


MOV 

#BLKE01,BLKTYP 

1 SET BLOCK TYPE! 1 

11 

12054 



CALL 

objsni 

UNIT THE POINTERS 


12054 

004767 

001542 


JSR 

PO»OBJ INI 


12 

12060 

012701 

300050' 


MOV 

#PRGTTUR1 

1 SET "FROM" INDEX 

13 

12064 

016702 
000549' 


MOV 

RLDPNT,R2 

? AND "TO" INDEX 

14 

12070 



CALL 

GSDDMP 

jOUTPUT GSD BLOCK 


12070 

304767 

000660 


JSR 

PC*GSDDMP 


15 

12074 

005046 


CLR 

■’ISP) 

UNIT FOR SECTOR SCAN 

16 

12076 

012667 

000006' 

1011 

MOV 

(SP+.ROLUPD 

I SET SCAN MARKER 

17 

12102 



NEXT 

SECROL 

1 GET THE NEXT SECTOR 


12102 

012700 


MOV 

#SECROL*R0 



000010 






12106 

004767 

003400 


JSR 

PG# NEXT 


18 

12112 

001430 


BCQ 

201 

IBRANCH IF THROUGH 

19 

12114 

016746 
000006' 


MOV 

RQLUPDi-(SP) 

jSAve marker 

21 

12124 

011105 


MOV 

(R1),R5 

ISAVE SECTOR 

22 

12126 

042705 

000377 


BIG 

#377iRS 

IISOLATE IT 

23 

12132 

000305 


SWAB 

RS 

I AND PLACE IN RIGHT 

24 

12134 

042711 


81C 

#-l-<RELFLG>,(Rl) |CLEAR ALL BUT REL BIT 



177737 





25 

12140 

0S2721 

000410 


BIS 

#<GSDT01>4-DEFFLG 

i<R1> + J SET TO TYPE 1, OEFI 

26 

12144 

010521 


MOV 

RS,<R1) + 

JASSUME ABS 

27 

12146 

301401 


BEQ 

us 

1 OOPS! 

28 

12150 

011141 


MOV 


f REL* SET MAX 


Figure 7-1 
Assembly Listing 
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29 

12152 

005067 

000006' 

US! 

Ct»B 

RQLUPD 

I SET FOR INNER SCAN 

30 

12156 

012731 
003002' 

12$ 

MOV 

#symbol,ri 


31 

12162 



call 

GSDDMP 

ioutput this block 


12162 

304767 

303566 


JSR 

PC # GSODMP 


32 

12166 


13$ | 

NEXT 

SYMBOL 

{FETCH THE NEXT SYMBOL 


12166 

312700 

303000 


MOV 

#SYMBGI»R0 



12172 

004767 

005314 


JSR 

PC,NEXT 


33 

12 

001737 


BEQ 

10$ 

> finished with this 

34 

12200 

032767 
000100 
300036' 


BIT 

PGL0FLG,MODE 

{GLOBAL? 

35 

12206 

301767 


BEQ 

13$ 

1 NO 

36 

12210 

126705 
000007 ' 


CMPB 

SECTOR,R§ 

{YES, PROPER SECTOR? 

37 

12214 

001364 


BNE 

13$ 

J NO 

30 

12216 

042767 


BIG 

P^l-<DEFFLG*RELFLGlGLBFLG>,MODE |CLEAR 



177627 

000006' 





39 

12224 

352767 

002000 

303005' 


BIS 

#GSDT04,MODE 

!SET TYPE 4 

40 

12232 

303751 


BR 

12$ 

{OUTPUT IT 


Figure 7-1 (Cent®) 
Assembly Listing 
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APPENDIX A 


MACH CHARACTER SETS 


A.l ASCII CHARACTER SET 


EVEN 

PARITY 

BIT 

7-BIT 

OCTAL 

CODE 

CHARACTER 

0 

000 

NUL 

1 

001 

SOH 

1 

002 

STX 

0 

003 

ETX 

I 

’ 004 

EOT 

0 

005 

ENQ 

0 

006 

ACK 

1 

007 

BEL 

1 

010 

BS 

0 

Oil 

HT 

0 

012 

LF 

1 

013 

VT 

0 

014 

FF 

1 

015 

CR 

1 

016 

SO 

0 

017 

SI 

1 

020 

DLE 

0 

021 

DC1 

0 

022 

DC2 

1 

023 

DC 3 

0 

024 

DC4 

1 

025 

NAK 

1 

026 

SYN 

0 

027 

ETB 


REMARKS 


NULL, TAPE FEED, CONTROL/SHIFT/P. 
START OF HEADINGl ALSO SOM, START 
OF MESSAGE, CONTROL/A. 

START OF TEXT; ALSO EOA, END OF 
ADDRESS, CONTROL/B. 

END OF TEXT; ALSO EOM, END OF 
MESSAGE, CONTROL/C. 

END OF TRANSMISSION (END); SHUTS 
OFF TWX MACHINES, CONTROL/D. 

ENQUIRY (ENQRY); ALSO WRU, 

CONTROL/E. 

ACKNOWLEDGE; ALSO RU, CONTROL/F 
RINGS THE BELL. CONTROL/G. 
BACKSPACE; ALSO FEO, FORMAT 
EFFECTOR. BACKSPACES SOME 
MACHINES. CONTROL/H. 

HORIZONTAL TAB. CONTROL/I. 

LINE FEED OR LINE SPACE (NEW LINE ); 
ADVANCES PAPER TO NEXT LINE, 
DUPLICATED BY CONTROL/J. 

VERTICAL TAB (VTAB). CONTROL/K. 

FORM FEED TO TOP OF NEXT PAGE 
(PAGE). CONTROL/L. 

CARRIAGE RETURN TO BEGINNING OF 
LINE. DUPLICATED BY CONTROL/M. 
SHIFT OUT; CHANGES RIBBON COLOR TO 
RED. CONTROL/N. 

SHIFT IN; CHANGES RIBBON COLOR TO 
BLACK. CONTROL/O. 

DATA LINK ESCAPE. CONTROL/B (DCO). 
DEVICE CONTROL 1, TURNS TRANSMITTER 
(READER) ON, CONTROL/Q (X ON). 

DEVICE CONTROL 2, TURNS PUNCH OR 
AUXILIARY ON. CONTROL/R (TAPE, 

AUX ON). 

DEVICE CONTROL 3, TURNS TRANSMITTER 
(READER) OFF, CONTROL/S (X OFF). 
DEVICE CONTROL 4, TURNS PUNCH OR 
AUXILIARY OFF. CONTROL/T (AUX OFF). 
NEGATIVE ACKNOWLEDGE; ALSO ERR, 
ERROR. CONTROL/U. 

SYNCHRONOUS FILE (SYNC). CONTROL/V. 
END OF TRANSMISSION BLOCK; ALSO 
LEM, LOGICAL END OF MEDIUM. 
CONTROL/W. 
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EVEN 

PARITY 

BIT 


0 

1 

1 

1 

1 

0 

0 

1 

1 

0 

0 

1 

0 

1 

1 

0 

0 

1 

1 

0 

1 

0 

0 

1 

0 

1 

1 

0 

1 

0 

0 

1 

1 

0 

0 

1 

0 

1 

1 

0 

1 

0 

0 

1 

0 

1 

1 

0 

0 

1 

1 


7-BIT 

OCTAL 

CODE 

CHARACTER 

030 

CAN 

031 

EM 

032 

SUB 

033 

ESC 

034 

FS 

035 

GS 

036 

RS 

037 

US 

040 

SP 

041 

1 

042 

8? 

043 

# 

044 

$ 

045 

% 

046 

& 

047 

» 

050 

( 

051 

5 

052 

* 

053 

+ 

054 

8 

055 


056 

© 

057 

/ 

060 

0 

061 

1 

062 

2 

063 

3 

064 

4 

065 

5 

066 

6 

067 

7 

070 

8 

071 

9 

072 

i 

073 

I 

074 

< 

075 

as 

076 

> 

077 

? 

100 

@ 

101 

A 

102 

B 

10 3 

C 

104 

D 

105 

E 

106 

F 

107 

G 

110 

H 

111 

I 

112 

J 


REMARKS 


CANCEL (CANCL)* COMTROL/X© 

END OF MEDIUM @ CONTROL/Y© 
SUBSTITUTE . CONTROL/Z* 

ESCAPE. CONTROL/SHXFT/K© 

FILE SEPARATOR© CONTROL/SHIFT/L © 
GROUP SEPARATOR© CONTROL/SHIFT/M© 
RECORD SEPARATOR. CONTROL/SHIFT/N© 
UNIT SEPARATOR© CONTROL/SHIFT/O© 
SPACE © 


ACCENT ACUTE OR APOSTROPHE © 
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SVEN 

7-BIT 




PARITY 

OCTAL 




BIT 

CODE 

CHARACTER 

REMARKS 


0 

113 

K 



1 

114 

L 



0 

115 

M 



0 

116 

N 



1 

117 

0 



0 

120 

P 



1 

121 

0 



1 

122 

R 



0 

123 

S 



1 

124 

T 



0 

125 

U 



0 

126 

V 



1 

127 

w 



1 

130 

X 



0 

131 

Y 



0 

132 

Z 



1 

133 

[ 

SHIFT/K. 


0 

134 

\ 

SHIFT/L. 


1 

135 

] 

SHIFT/M. 


1 

136 

t 



0 

137 

4“ 



0 

140 

* 

ACCENT GRAVE. 


1 

141 

a 



1 

142 

b 



0 

143 

c 



1 

144 

d 



0 

145 

e 



0 

146 

f 



1 

147 

g 



1 

150 

h 



0 

151 

i 



0 

152 

j 



1 

153 

k 



0 

154 

1 



1 

155 

m 



1 

156 

n 



0 

157 

o 



1 

160 

P 



0 

161 

q 



0 

162 

r 



1 

163 

S 



0 

164 

t 


* ,a K 

1 

165 

u 



• 1 

166 

V 



0 

167 

w 



0 

170 

X 



1 

171 

Y 



1 

172 

z 



0 

173 




1 

174 




0 

175 


THIS CODE GENERATED BY ALTMODE 


0 

176 


THIS CODE GENERATED BY PREFIX : 





(IF PRESENT). 


1 

111 

DEL 

DELETE s RUBOUT. 
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A© 2 RADIX-50 CHARACTER SET 


Character 


apace 

A-Z 

$ 

© 

unused 
0 = 9 


ASCII Octal 
Equivalent 


40 

101 - 132 
44 
56 

60 = 71 


Radix-5 0 
Equivalent 


0 

1-32 

33 

34 

35 

36 - 47 


The maximum Radix-50 value is, thus, 

47*50(2) + 47*50 + 47 = 174777 

The following table provides a convenient means of translating between 
the ASCII character set and its Radix-50 equivalents. For example, 
given the ASCII string X2B* the Radix-50 equivalent is (arithmetic 
performed in octal )% 

X - 113000 
2 = 002400 
B = 000002 
X2B » 115402 
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Single 

or 

First 

Char. 

Char. 

Second 

Character 

Third 

Character 

A 

003100 

A 

000050 

A 

000001 

B 

006200 

B 

000120 

B 

000002 

C 

011300 

C 

000170 

C 

000003 

D 

014400 

D 

000240 

D 

000004 

E 

017500 

E 

000310 

E 

000005 

F 

022600 

F 

000360 

F 

000006 

G 

025700 

G 

000430 

G 

000007 

H 

031000 

H 

000500 

H 

000010 

I 

034100 

I 

000550 

I 

000011 

J 

037200 

J 

000620 

J 

000012 

K 

042300 

K 

000670 

K 

000013 

L 

045400 

L 

000740 

. L 

000014 

M 

050500 

M 

001010 

M 

000015 

N 

053600 

N 

001060 

N 

000016 

0 

056700 

0 

001130 

0 

000017 

P 

062000 

P 

001200 

P 

000020 

Q 

065100 

Q 

001250 

Q 

000021 

R 

070200 

R 

001320 

R 

000022 

S 

073300 

S 

001370 

S 

000023 

T 

076400 

T 

001440 

T 

000024 

U 

101500 

U 

001510 

U 

000025 

V 

104600 

V 

001560 

V 

000026 

w 

107700 

w 

001630 

w 

000027 

X 

113000 

X 

001700 

X 

000030 

Y 

116100 

Y 

001750 

Y 

000031 

z 

121200 

Z 

002020 

z 

000032 

$ 

124300 

$ 

002070 

$ 

000033 

® 

127400 

© 

002140 

© 

000034 

unused 

132500 

unused 

002210 

unused 

000035 

0 

135600 

0 

002260 

0 

000036 

1 

140700 

1 

002330 

1 

000037 

2 

144000 

2 

002400 

2 

000040 

3 

147100 

3 

002450 

3 

000041 

4 

152200 

4 

002520 

4 

000042 

5 

155300 

5 

002570 

5 

000043 

6 

160400 

6 

002640 

6 

000044 

7 

163500 

7 

002710 

7 

000045 

8 

166600 

8 

002760 

8 

000046 

9 

171700 

9 

003030 

9 

000047 


A“5 




V 



APPENDIX B 







MACH ASSEMBLY LANGUAGE AND ASSEMBLER 


B.l SPECIAL CHARACTERS 


Character 


Function 


form feed 
line feed 
carriage return 
vertical tab 


% 

tab 

space 

# 

§ 

( 

) 

s (comma) 


+ 


* 

/ 

& 

l 

58 


Source line terminator 

Source line terminator 

Formatting character 

Source line terminator 

Label terminator 

Direct assignment indicator 

Register term indicator 

Item terminator 
Field terminator 

Item terminator 
Field terminator 

Immediate expression indicator 

Deferred addressing indicator 

Initial register indicator 

Terminal register indicator 

Operand field separator 

Comment field, indicator 

Arithmetic addition operator or 
autoincrement indicator 

Arithmetic subtraction operator or 
autodecrement indicator 

Arithmetic multiplication operator 

Arithmetic division operator 

Logical AND operator 

Logical OR operator 

Double ASCII character indicator 
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9 


(apostrophe) 


Single ASCII line indicator 


< 

> 

t 

\ 

B@ 2 ADDRESS MODE SYNTAX 

n is an integer between 0 and 7 
register expression^ E Is an 
expression or an expression In t3 


Assembly location counter 

Initial argument indicator 

Terminal argument indicator 

Universal unary operator 
Argument Indicator 

MACRO numeric argument indicator 

representing a register® R Is a 
expression^ ER is either a register 
e range 0 to 7© 


Address 

Format Mode Name 


Address 
Mode Number 


Meaning 


R 

Register 

On 

@R or (ER) 

Deferred 

Register 

In 

(ER) + 

Autoincrement 

2n 

@ (ER) + 

Deferred 

Autoincrement 

3n 

-(ER) 

Autodecrement 

4n 

(ER) 

Deferred 

Autodecrement 

5 n 

E (ER) 

Index 

6n 


@E(ER) Deferred Index 7n 


Register R j contains the 
operand. R is a register 
expression® 

Register R contains the 
operand address® 

The contents of the register 
specified by ER are 
incremented after being used 
as the address of the operand® 

ER contains the pointer to the 
address of the operand® ER Is 
incremented after use® 

The contents of register ER 
ar® decremented before being 
used as the address of the 
operand® 

The contents of register ER 
are decremented before being 
used as the pointer to the 
address of the operand® 

E plus the contents of the 
register specified , ER # is the 
address of the operand® 

E added to ER gives the 
pointer to the address of the 
operand. 
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#E 

Immediate 

27 

@#E 

Absolute 

37 

E 

Relative 

67 

@E 

Deferred 

77 


Relative 



B*3 INSTRUCTIONS 


E is the operand® 


E is the 

address 

of 

the 

operand. 




E is the 

address 

of 

the 

operand. 





E is the pointer to the add¬ 
ress of the operand® 


The instructions which follow are grouped according t© the operands 
they take and the bit patterns of their op-codes® 


In the instruction-type format specification 9 the following symbols 
are usedi 

OP Instruction mnemonic 

R Register expression 

E Expression 

ER Register expression or expression 0<ER<7 

A General address specification 

In the representation of op-codes, the following symbols are usedi 

SB Source operand specified by a 6-bit address mode® 

DD Destination operand specified by a 6-bit address 

mode. 


3-bit offset to a location (branch instructions)© 

R Integer between 0 and 7 representing a general 

register® 

Symbols used in the description ©f instruction operands arei 


BE Source Effective Address 

Destination Effective address 
1 1 Absolute value of 

( ) Contents of 

Becomes 


The condition codes in the processor status word (PS) are affected by 
the instructions® These condition codes are represented as followsi 

N Negative bits set if the result is negative 

% Zero biti set if the result is sero 


V overflow biti set if the operation caused an overflow 

C Carry bits set if the operation caused a carry® 

In the representation of the instruction^ effect on the condition 
codes r the following symbols are usedi 
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* Conditionally set 

- Not affected 

0 Cleared 

1 Set 

To set conditionally means to use the instruction's result to 
determine the state of the code (see the PDP-11 Processor Handbook)© 

Logical operations are represented by the following symbols! 

I Inclusive OR 

(D Exclusive OR 

a AND 

(used over a symbol) NOT (i @ e© , l f s complement) 


3 & 3 @ ± Double-Operand Instructions 
Instruction type formats Op A,A 


Status Word 
Condition Codes 


Op-Code 

Mnemonic 

Stands for 

Operation 

N 

% 

V 

c 

01SSDD 

MOV 

MOVe 

CSS) (DE) ' 

* 

ft 

0 


11SSDD 

MOVE 

MOVe Byte 






02SSDD 

CMP 

CoMPare 

(SE)-(DE) 

* 

* 

ft 

ft 

12SSDD 

CMPB 

CoMPare Byte 






03SSDD 

BIT 

Bit Test 

(SE)&(DE) 

ik 

ft 

0 


13SSDD 

BITE 

Bit Test Byte 






04SSDD 

BIG 

Bit Clear 

(SE) & (DE)-*DE 

ft 

ft 

0 

—) 

14SSDD 

BICB 

Bit Clear Byte 






05SSDD 

BI 01 

Bit Set 

(SE) 1 (DE)+DE 

* 

ft 

0 

earn 

15SSDD 

BXSB 

Bit Set Byte 






06SSDD 

ADD 

ADD 

(SE)+(DE)^DE 

ft 

ft 

ft 

ft 

16SSDD 

SUB 

SUBtract 

(DE) — (SE) -> E 

ft 

ft 

ft 

ft 

B.3.2 Single-Operand Instructions 






Instruction-type : 

formati Op A 










Status 

Word 





Condition Codes 

Op-Code 

Mnemonic 

Stands for 

Operation 

N 

2 

V 

c 

0050DD 

CLR 

CLear 

0 DE 

0 

1 

0 

0 

1050DD 

CLRB 

CLear Byte 






0051DD 

COM 

COMplement 

(DE) DE 

ft 

ft 

0 

1 

1051DD 

COMB 

COMplement Byte 
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0052DD 

1052DD 

INC 

INCH 

increment 
increment Byte 


0053DD 

1053DD 

DEC 

DECS 

DECrement 
DECrement Byte 


0054DD 

1054DD 

NEG 

NEGB 

NEGate 

NEGate Byte 


0055DD 

1055DD 

ADC 

ADCB 

ADd Carry 

ADd Carry Byte 


0056DD 

1056DD 

SBC 

SBCB 

SuBtract Carry 
SuBtract Carry 


0057DD 

1057DD 

TST 

TSTB 

TeST 

TeST Byte 


0060DD 

ROR 

Rotate Right 

% 

1060DD 

RORB 

Rotate Right 
Byte 


0061DD 

ROL 

Rotate Left 



1061DD 

ROLB 

Rotate Left 
Byte 


0062DD 

ASH 

Arithmetic 
Shift Right 



1062DD 

ASRB 

Arithmetic 
Shift Right 
Byte 


0063DD 

ASL 

Arithmetic 
Shift Left 


1063DD 

AS LB 

Arithmetic 
Shift Left 
Byte 


0001DD 

JMP 

jump 


0003DD 

SWAB 

SWAp Bytes 


0067DD 

SXT 

Sign eXTend 


0707DD 

NRGD 

NEGate Double 


(DE)+1 DE 


(DE)-l DE 


(DE)+1 DE 


(DE) + (C) DE 


(DE) — (C) DE 

Byte 


(DE) “0 DE 



Bn 


I —HE 1— El¬ 


even or odd byte 


Bn 


czE- 


>—i 


even or odd byte 



even or odd byte 



DE PC 


0 DE if N bit 
clear 

-1 DE if N bit 
is set 


—(fDe) fde 



* * * 


& it # 


* * * it 


* # * * 


* * * * 




it it is 


it a * a 


it is is it 


& it is it 


* * * * 


it * * * 


* * * * 


* * * * 


& ^ Q 0 

— * .. <* 


FN FZ FV FC 
& & 0 0 
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1704DD 

CLRD 

CLeaR Double 

0 FDE 

1705DD 

TSTD 

TeST Doubel 

(FDE)-O FDE 

1706DD 

ABSD 

make ABSolute 

FDE FDE 

B.3.3 

Operate Instructions 


Instruction-Type 

format % Op 


Op—Code Mnemonic 

Stands for 

Operation 

000000 

HALT 

HALT 

The computer stops 
all functions. 

000001 

WAIT 

WAIT 

The computer stops 
and waits for an 
interrupt. 

000002 

RTI 

ReTurn from 
Interrupt 

The PC and PS are 
popped off the SP 
stacks 




((SP))+PC 
(SP)+2+SP 
( (SP) )+PS 
(SP) +2-*-SP 




RTI is also used 
to return from a 
trap. 

000005 

RESET 

RESET 

Returns all I/O 
devices to power-on 
status. 

000241 

CL,C 

CLear Casrjry bit 

0-*-C 

000261 

SEC 

SEt Carry bit 

1->C 

000242 

CLV 

CLear overflow bit 

o+v 

000262 

SEV 

SEt overflow bit 

1-*V 

000244 

CLZ 

CLear Zero bit 

0-*S5 

000264 

SEZ 

SEt Zero bit 

1+Z 

000250 

CLN 

CLear Negative bit 

O-’-N 

000270 

SEN 

SEt Negative bit 

X-*-N 

000243 

cvc 

Clear overflow and 
Carry bits 

o-*v 

000254 

CNZ 

Clear Negative and 
Zero bits 

0-5-N 

0-5-Z 



000257 CCC Clear all 0+N 

Condition Codes 0-*-Z 

0-*V 

0-*-C 

000277 SCC Set all 1-s-N 

Condition Codes l-*-S§ 

l+V 

1-s-C 


000240 NOP No Operation 


B.3.4 Trap Instructions 

Instruction-type formats Op or Op E where 0 < E < 377(8) 

*OP (only) 


0 0 0 0 


1111 


Op-Code 

Mnemonic 

Stands for 

000003 

BPT 

Breakpoint Trap 

*000004 

IOT 

Input/Output Trap 

104000- 

104377 

EMT 

EMulator Trap 

104400- 

104777 

TBAP 

TRAP 


Status Word 
Condition Codes 
Operation N Z V C 


Trap to location 
14. This is used 
to call ODT. 

Trap to location 
20. This is used 
to call IOX. 


Trap to location 
30. This is used 
to call system 
programs. 

Trap to location 
34. This is used 
to call any routine 
desired by the 
programmer. 
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B•3.5 Branch Ins tractions 

Instraction-type formati Op E where -128(10) < (E—.-2)/2 < 127(10) 


Condition to be 
met if branch 


Op-Code 

Mnemonic 

Stands for 

is to occur 

0004XX 

BR 

BRanch always 


0010XX 

BNE 

Branch if Not 

Equal (to zero) 

GS 

11 

O 

0014XX 

BEQ 

Branch if EQual 
(to zero) 

Z-l 

0020XX 

BGE 

Branch if 

Greater than or 

Equal (to zero) 

N (D V^O 

0024XX 

BLT 

Branch if Less 
than (zero) 

N © V—1 

003QXX 

BGT 

Branch if 

Greater than 
(zero) 

Zt (N © V) -0 

0034XX 

BLE 

Branch if Less 
than or equal 
(to zero) 

Z!«- (N © V)=l 

1000XX 

BPL 

Branch if PLus 

N—0 

1004XX 

BMI 

Branch if Minus 

N—1 

1010XX 

BHI 

Branch if 

Higher 

o 

N 

11 

O 

1014XX 

BLOS 

Branch if LOwer 
or Same 

C I z—1 

1020XX 

BVC 

Branch if 
overflow Clear 

v=o 

1024XX 

BVS 

Branch if 
overflow Set 

V=1 

1030XX 

BCC 

(or BBIS) 

Branch if Carry 

Clear (or 

Branch if 

Higher or Same) 

o 

11 

O 

1034XX 

BCS 

Branch if Carry 

C«1 


(or BLOS) Set (or Branch 
if Lower 



B.3.6 Register Destination 
Instruction type formats Op ER,A 


Status Word 
Condition Codes 

Op-Code Mnemonic 


004RDD JSR 

the PC in the 
register. 

DE TEMP (TEMP= 
temporary storage 
register internal 
to processor.) 

(SP )-2 SP 
(REG) (SP) 

(PC) REG 
(TEMP) PC 


Stands for 


Operation 


N Z V C 


Jump to SubRoutine 


Push register on 

jui* ears 


The following instruction is available only on the PDP-11/45i 
074RDD XOR exclusive OR (R) 1 DE DE * 


Be3 e 7 Subroutine Return 
Instruction type formati Op ER 


Op-Code Mnemonic 


Stands for 


Status Word 
Condition Codes 
Operation N Z V C 


00020R RTS 


ReTurn from 
Subroutine 


Put register in 
PC and pop old 
contents from SP 
stack into register 
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B B 4 


ASSEMBLER DIRECTIVES 


Form 


Operation 


Described 
in Manual 
Section 


§ 


if 


tBn 

tCn 

tDn 

ton 

©ASCII string 

@ASCIZ string 


@ BLKB exp 


A single-quote character 5® 3®3 

(apostrophe) followed by one 
ASCII character generates a 
word containing the 7-bii 
ASCII representation of the 
character in the low-order 
byte and zero in the high 
order byte® 

A double-quote character 5®3®3 

followed by two ASCII 
characters generates a word 
containing the 7-bit ASCII 
representation of the two 
characters® 

Temporary radix control; 5 @ 4®2 

causes the number n to be 
treated as a binary number. 

Creates a word containing the 5®6 @ 2 
one 8 s complement ©f n® 

Temporary radix controli 5 @ 4 e 2 

causae the number n to b® 
treated as a decimal number® 

Temporary radix control! 5®4®2 

causes the number n t© be 
treated as an octal number® 


Gosieira-tes a. block ©£ data 5 © 3 © 4 

containing the ASCII 
equivalent of the character 
string (enclosed in 
delimiting characters) one 
character per byt© @ 

Generates a block of data 5 @ 3 @ 5 

containing the ASCII 

equivalent of the character 

string (enclosed in 

delimiting characters) one 

character per byte with a 

zero byte following the 

specified string® 

Reserves a block of storage 5®5®3 

space exp bytes long® 
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FORM 

eBLKW exp 

©BYTE expl,@xp2,... 

©DSABL arg 

®ENABL arg 

@ END 

©END exp 

®ENDC 

®ENDM 

©ENDM symbol 

©ERROR exp^string 

©EVEN 

®IF cond g argl, arg2 f ® ® ® 

© IFF 


Operation 

Reserves a block of storage 
space exp words long© 

Generates successive bytes ©f 
data containing the octal 
equivalent of the expression(s) 
specified© 

Disables the assembler 
function specified by the 
argument© 

Provides the assembler 
function specified by the 
argument © 

Indicates the physical end 
of source program© An 
optional argument specifies 
the transfer address© 

Indicates the end of a 
conditional block© 

Indicates the end of the 
current repeat blocks 
indefinite repeat blacky or 
macro© The optional symbol , 
if us@d f must be identical to 
the macro name© 

Causes a text string to be 
output t© the command device 
containing the optional 
expression specified and the 
indicated text string© 

Ensures that the assembly 
location counter contains an 
even address by adding 1 if 
it is odd© 

Begins a conditional block of 
source code which is included 
in the assembly only if the 
stated condition is met 
with respect to the 
argument( s) specified © 

Appears only within a 
conditional block and 
indicates the beginning of a 
section of code to be 
assembled if the condition 
tested false© 


Described 
in Manual 
Section 

5® 5©3 

5©3® 1 

5© 2 

5©2 

5® 7© 1 

5 ® 11 

6 © 1 © 2 

6© 5 

5©5®1 

5® 11 

5 © 11®1 
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Form 
® IFT 


• IFTF 

• XXF cond^arg^statement 


® IRP sym,<argl f arg2,« © © > 


©IRPC sym f string 


.LIST 
©LIST arg 


©MACRO sym*argl*arg2*© © © 

©MEXXT 

©NARG symbol 


Operation 

Appears only within a 
conditional block and 
indicates the beginning of 
a section of code to fee 
assembled if the condition 
tested true® 

Appears only within a 
conditional block and 
indicates the beginning of 
a section of code to be 
unconditionally assembled© 

Acts as a Inline conditional 
block where the condition is 
tested for the argument 
specified® Ths statement 
is assembled only if the 
condition tests true © 

Indicates the beginning of 
an indefinite repeat block 
in which the symbol specified 
is replaced with successive 
elements of the real argument 
list (which is enclosed in 
angle brackets)® 

Indicates the beginning of an 
indefinite repeat block in 
which the symbol specified 
takes on the value of 
successive characters in the 
character string® 

With oust an argument ©LIST 

increments the listing level 
count by one® With an 
argument ©LIST does not alter 
the listing level count but 
formats the assembly listing 
according to the argument 
specified© 

Indicates the start of a 
macro named sym containing 
the disKiray arguments specified® 

Causes an exit from the 
current macro or indefinite 
repeat block• 

Appears only within a macro 
definition and equates the 
specified symbol to the 
number of characters in the 
string (enclosed in 
delimiting characters)© 


Described 
in Manual 
Section 

5®IX©1 

5.11.1 

5@11© 2 

6.6 

6&6 

5,1.1 

S @ 1 ® 1 

6® 1® 3 

6© 4 
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Form 

e NCHR sym F string 


e NLIST 
©NLIST arg 


oNTYPE sym^arg 


.ODD 


.PAGE 


@ PRINT exp^string 


®RADIX n 


oRAD50 string 


9 REFT exp 


.SBTTL string 


Described 
in Manual 

Operation Section 

Can appear anywhere in a 6.4 

source program; equates the 
symbol specified to the 
number of characters in the 
string (enclosed in 
delimiting characters)» 

Without an argument , ©NLIST 5 @ 1 @ 1 

decrements the listing level 
count by 1* With an argument § 

©NLXST deletes the portion of 
the listing indicated by the 
argument® 

Appears only in a macro 6.4 

definition and equates the 
low-order six bits of the 
symbol specified to the 
six-bit addressing mode of 
the argument® 

Ensures that the assembly X 

location counter contains an 
odd address by adding 1 if it 
is even. 

Causes the assembly listing 5.1.6 

to skip t© the top of the 
next page® 

Causes a text string to be 6®5 

output to the command device 
containing the optional 
expression specified and the 
indicated text string® 

Alters the current program 5.4.1 

radix to where n can be 2 f 
4, 8, or 10® 

Generates a block of data 5®3®6 

containing the Radix-50 
equivalent of the character 
string (enclosed in 
delimiting characters). 

Begins a repeat block® 6®7 

Causes the section of code 
up to the next .EHDM or 
or .EHDR to be repeated 
exp times® 

Causes the string to be 5.1.4 

printed as part of the 
assembly listing page header® 

The string part of each ©SBTTL 
directive is collected into 
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Described 
in Manual 

Form Operation Section 

a table of contents at the 
beginning of the assembly 
listing® 

0 TITLE string Assigns the first symbolic 5®1®3 

name in the string to the 
object module and causes the 
string to appear on each page 
of the assembly listing® 

One •TITLE directive should 
be issued per program® 

®WORD expl^@xp2 # ... Generates successive words 5®3®2 

of data containing the octal 
equivalent of the 
expression(s} specified® 
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APPENDIX C 


PST 


PERMANENT SYMBOL TABLE 

PERMANENT SYMBOL TABLE MACRO V004A PAGE 1 

.TITLE PST PERMANENT SYMBOL TABLE 
COPYRIGHT 1972 DIGITAL EQUIPMENT CORPORATION 


000020 DRI s3 200 
000100 DR2= 100 


IDESTRUCTIVE REFERENCE IN FIRST 
?DESTRUCTIVE REFERENCE IN SECOND 


000020 DFLGEV— 020 
000010 DFLGBM= 010 
000004 DFLCND- 004 
000002 DFLMAC= 002 


; DIRECTIVE REQUIRES EVEN LOCATION 
;DIRECTIVE USES BYTE MODE 
ICONDITIONAL DIRECTIVE 
jMACRO DIRECTIVE 


00000 


PSTBASi 


.IIF DF X45 r XFLTG= 0 
. IIF DF XMACRO, XSMCAL*= 0 

.MACRO OPCDEF NAME, CLASS, VALUE, FLAGS, 
.IF NB <COND> 

.IF DF COND 
.MEXIT 
.ENDC 
.ENDC 

.RAD50 /NAME/ 

.BYTE FLAGS+0 
.GLOBL OPCL 8 CLASS 
.BYTE 200+OPCL’CLASS 
.WORD VALUE 
.ENDM 

.MACRO DIRDEF NAME, FLAGS, COND 
.IF NB <COND> 

.IF DF COND 
.MEXIT 
.ENDC 
.ENDC 

.GLOBL NAME 
.RAD50 /.'NAME/ 

.BYTE FLAGS 4-0 

.BYTE 0 
.WORD NAME 
.ENDM 

; BASE 


COND 
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1 

000020 

OPCDEF 

<ABC 

y $ 

01, 

005500, DRl 

2 

000030 

OPCDEF 

<ABCB 

y ^ 

01, 

105500, DRl 

3 

000040 

OPCDEF 

<ADD- 

y 9 

02, 

060000, DR2 

4 

000110 

OPCDEF 

<A3L 

> f 

01, 

006300, DRl 

5 

000120 

OPCDEF 

<ASLB 

y § 

01, 

106300, DRl 

6 

000130 

OPCDEF 

<ASR 

>, 

01, 

006200, DRl 

7 

000140 

OPCDEF 

<ASRB 

>, 

01, 

106200, DRl 

e 

000150 

OPCDEF 

<BCC 

>, 

04, 

103000, 

9 

000160 

OPCDEF 

<BGS 


04, 

103400, 

10 

000170 

OPCDEF 

<BEQ 

y f 

04, 

001400, 

11 

000200 

OPCDEF 

<BGB 

y § 

04, 

002000, 

12 

000210 

OPCDEF 

<BGT 

y § 

04, 

003000, 

13 

000220 

OPCDEF 

<BHI 

>, 

04, 

101000, 

14 

000230 

OPCDEF 

<BB1S 

>> 

04, 

103000, 

15 

000240 

OPCDEF 

<BIC 

y p 

02, 

040000, DR2 

16 

000250 

OPCDEF 

<BICB 

>* 

02, 

140000, DR2 

17 

000260 

OPCDEF 

<BIS 

>, 

02, 

050000, DR2 

18 

000270 

OPCDEF 

<BISB 

>, 

02, 

150000, DR2 

19 

000300 

OPCDEF 

<BIT 

y & 

02, 

030000, 

20 

000310 

OPCDEF 

<BITB 

>* 

02, 

130000, 

21 

000320 

OPCDEF 

<BM 

y # 

04, 

003400, 

22 

000330 

OPCDEF 

<BLO 

>, 

04, 

103400, 

23 

000340 

OPCDEF 

<BX*OS 

y § 

04, 

101400, 

24 

000350 

OPCDEF 

<BLT 

>, 

04, 

002400, 

25 

000360 

OPCDEF 

<BMI 

>, 

04, 

100400, 

26 

000370 

OPCDEF 

<BNE 

>, 

04, 

001000, 

27 

000400 

OPCDEF 

<BPL 

>, 

04, 

100000, 

20 

000420 

OPCDEF 

<BR 

>, 

04, 

000400, 

29 

000430 

OPCDEF 

<B¥C 

>, 

04, 

102000, 

30 

000440 

OPCDEF 

<BV3 

>, 

04, 

102400, 

31 

000450 

OPCDEF 

<ccc 

>, 

00, 

000257, 

33 

000470 

OPCDEF 

<CLC 

y § 

00, 

000241, 

34 

000500 

OPCDEF 

<CLM 

y 9 

00, 

000250, 

35 

000510 

OPCDEF 

<CLR 

>, 

01, 

005000, DRl 

36 

000520 

OPCDEF 

<CLRB 


01, 

105000, DRl 

39 

000550 

OPCDEF 

<CLV 

>, 

00, 

000242, 

40 

000560 

OPCDEF 

<GLZ 


00, 

000244, 
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1 

000570 

•$ 

OPCDEF 

<CMP >, 

02, 

020000, 

2 

000600 


OPCDEF 

<CMPB >, 

02, 

120000, 



CMZ 

00 

000254, 



3 

000630 


OPCDEF 

<COM >, 

01, 

005100, DR1 

4 

000640 


OPCDEF 

<COMB >, 

01, 

105100, DR1 

5 

000650 


OPCDEF 

<DEC >, 

01, 

005300, DRl 

6 

000660 


OPCDEF 

<DECB >, 

01, 

105300, DRl 

7 

000670 


OPCDEF 

<EMT >, 

06, 

104000, 

8 

000730 


OPCDEF 

<HALT >, 

00, 

000000, 

9 

000740 


OPCDEF 

<INC >, 

01, 

005200, DRl 

10 

000750 


OPCDEF 

<INCB >, 

01, 

105200, DRl 

11 

000760 


OPCDEF 

<IOT >, 

00, 

000004, 

12 

000770 


OPCDEF 

<JMP >, 

01, 

000100, 

13 

001000 


OPCDEF 

<JSR >, 

05, 

004000, DRl 

14 

001010 


OPCDEF 

<MOV >, 

02, 

010000, DR2 

15 

001230 


OPCDEF 

<MOVB >, 

02, 

110000, DR2 

16 

001240 


OPCDEF 

<NEG >, 

01, 

005400, DRl 

17 

001320 


OPCDEF 

<NEGB >, 

01, 

105400, DRl 

18 

001330 


OPCDEF 

<NOP >, 

00, 

000240, 

19 

001360 


OPCDEF 

<RESET>, 

00, 

000005, 

20 

001370 


OPCDEF 
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1 

001400 

OPCDEF 

<KOL 

> , 

01, 

006100, 

DR1 

2 

001410 

OPCDEF 

<ROLB 

>, 

01, 

106100, 

DRl 

3 

001420 

OPCDEF 

<ROR 

>, 

01, 

006000, 

DR1 

4 

001430 

OPCDEF 

<RORB 

>r 

01, 

106000, 

DRl 

5 

001440 

OPCDEF 

<RTI 

> , 

00, 

000002, 


6 

001450 

OPCDEF 

<RTS 

y § 

03, 

000200, 

DRl 

7 

001470 

OPCDEF 

<SBC 

y ^ 

01, 

005600, 

DRl 

8 

001500 

OPCDEF 

<SBCB 

>, 

01, 

105600, 

DRl 

9 

001510 

OPCDEF 

<SCC 

>, 

00, 

000277, 


10 

001520 

OPCDEF 

<SEC 

> 

00, 

000261, 


11 

001530 

OPCDEF 

<SEN 

y § 

00, 

000270, 


12 

001600 

OPCDEF 

<SB¥ 

y § 

00, 

000262, 


13 

001610 

OPCDEF 

<BEZ 

>, 

00, 

000264, 


14 

002020 

OPCDEF 

<SUB 

># 

02, 

160000, 


15 

002050 

OPCDEF 

<SWAB 

>, 

01, 

000300, 

DRl 

16 

002070 

OPCDEF 

<TRAP 

>, 

06, 

104400, 


17 

002100 

OPCDEF 

<TST 

y 9 

01, 

005700, 


18 

002110 

OPCDEF 

<TSTB 

y § 

01, 

105700, 


19 

002140 

OPCDEF 

<WAIT 

> , 

00, 

000001, 
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1 

002160 

DIBBEF 

<ASCII>, 

DFLGBM 


2 

002170 

BXKDEF 

<ASCIZ>, 

DFLGBM 


3 

002210 

DXRDEF 

<BLKB >* 



4 

002220 

DXRBEF 

<BLKW >* 

DFLGEV 


5 

002230 

DXRDEF 

<BYTE >, 

DFLGBM 


6 

002250 

DXRDEF 

<DSABL>, 



7 

002260 

DXRDEF 

<BNABL>^ 



e 

002270 

DXRDEF 

<END > f 



9 

002300 

DXRDEF 

<ENDC >, 

DFLCND 


10 

002310 

DXRDEF 

<ENDM >, 

DFLMAC, XMACRO 


11 

002320 

DXRDEF 

<ENDR > f 

DFLMAC, XMACRO 


12 

002340 

DXRDEF 

<ERROR> f 



13 

002350 

DXRDEF 

<EVEN >, 



14 

002420 

DXRDEF 

<IF >, 

DFLCND 


15 

002430 

DXRDEF 

<XFDF > # 

DFLCND 


16 

002440 

DXRDEF 

<IFEQ >, 

DFLCND 


17 

002450 

DXRDEF 

<IFF >, 

DFLCND 


18 

002460 

DXRDEF 

<IFG >, 

DFLCND 


19 

002470 

DXRDEF 

<XFGE > # 

DFLCND 


20 

002500 

DXRDEF 

<IFGT >, 

DFLCND 


21 

002510 

DXRDEF 

<IFL >, 

DFLCND 


22 

002520 

DXRDEF 

<XFX*E 

DFLCND 


23 

002530 

DXRDEF 

<IFLT >» 

DFLCND 


24 

002540 

DXRDEF 

<XFNDF> # 

DFLCND 


25 

002550 

DXRDEF 

<XFNE >, 

DFLCND 


26 

002560 

DXRDEF 

<IFNZ > t 

DFLCND 


27 

002570 

DXRDEF 

<IFT >, 

DFLCND 


28 

002600 

DXRDEF 

<XFTF 

DFLCND 

■O 

29 

002610 

DXRDEF 

<IFZ >, 

DFLCND 


30 

002620 

DXRDEF 

<IIF >„ 



31 

002630 

DXRDEF 

<IRP >* 

DFLMAC* XMACRO 


32 

002640 

DXRDEF 

<IRPC >, 

DFLMAC* XMACRO 


33 

002660 

DXRDEF 

<LIST >, 
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002670 

DXRBEF 

<MACR >, 

BFXsMAC^ XMACRO 

002700 

BXRBEF 

<MACRO>, 

BFLMAC f XMACRO 

002720 

DXRDEF 

<MEXIT>, 

§ XMACRO 

002730 

DXRBEF 

<NARG >, 

f XMACRO 

002740 

DXRDEF 

<NCHR >, 

* XMACRO 

002750 

DXRBEF 

<NLIST > 


002760 

DXRDEF 

<NTYPE>*r 

* XMACRO 

002770 

DXRBEF 

<ODD >, 


003000 

DXRBEF 

<PAGE y, 


003010 

DXRBEF 

<PRINT>* 


003020 

DXRBEF 

<RADIX> f 


003030 

DXRBEF 

<RAD50>, 

DFLQRV 

003040 

DXRDEF 

<REM >, 


003050 

DXRDEF 

<REPT >, 

DFLMAC* MACRO 

003060 

DXRDEF 

<SBTTL >, 


003070 

DXRDEF 

<TITLE >, 


003100 

WRDSYMi 



003100 

DXRDEF 

<WORD >» 

DFLGEV 

003110 

PSTTOPi 


j?TOP LIMIT 


000001 *END 
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ERROR MESSAGE SUMMARY 


D.l MAC11 ERROR CODES 

MACH error codes are printed following a field of six asterisk 
characters and on the line preceding the source line containing the 
error. For examples 

26 00236 000002 § ©WORD RBL14-REL2 

The addition of two relocatable symbols is flagged as an A error© 


Error Code 


Meaning 




A Addressing error© An address within the 

instruction is incorrect© Also may indicate a 

relocation error© This message does not 

necessarily reflect a coding error© 

B Bounding error© Instructions or word data are 

being assembled at an odd address in memory© The 
location counter is updated by +1. 

D Doubly^defined symbol referenced© Reference was 

made to a symbol which is defined more than once® 

E End directive not found© (A listing is 

generated©) 

I Illegal character detected© Illegal characters 

which are also nonprinting are replaced by a ? on 
the listing® The character ie then ignored© 

L Line buffer overflow % i e e® f Input line greater 

than 132 „ Escfcx’a. characters on at Xxnse 

(more than 72(10)) are ignored© 

M Multiple definition of a label® A label was 

encountered which was equivalent (in the first six 
characters) to a previously encountered label® 

N Number containing 8 or 9 has decimal point 

missing© 

O Op-code error® Directive out of context® 

P Phase error© A label 0 s definition of value varies 

from one pass to another© 

Q Questionable syntax® There are missing arguments 

or the instruction scan was not completed or a 
carriage return was not immediately followed by a 
line feed or form feed© 


D-l 



Register—type error. An invalid use of or 
reference to a register has been made. 

Truncation error. A number generated more than 16 
bits of significance or an expression generated 
more than 8 bits of significance during the use of 
the .BYTE directive. 

Undefined symbol. An undefined symbol was 
encountered during the evaluation of an 
expression. Relative to the expression, the 
undefined symbol is assigned a value of zero. 

Instruction which is not compatible among all 
members of the PDP-11 family (11/15, 11/20, and 
11/45). 



INDEX 


Absolute mode, 4-5 
Addressing modes, 4-1 

branch instruction, 4-7 
preferred, 1-6 
syntax, B-2 

.ASCII directive, 5-11 
.ASCIZ directive, 5-12 
Assembler directives, 5-1, B-10 
Assembly language and assembler,B-1 
Assembly instructions, B-3 
branch, B-8 
double-operand, B-4 
operator, B-6 
single-operand, B-4 
subroutine return, B-9 
trap, B-7 

Assembly location counter, 3-10 
Assembly listing, example, 7-3 
Autodecrement deferred mode, 4-3 
Autodecrement mode, 4-3 
Autoincrement deferred mode, 4-3 
Autoincrement mode, 4-2 
Automatically created symbols, 6-7 


Concatenation, 6-8 
Conditional assemblies, 1-6 
directives, 5-18 
Conversion (ASCII) of one or 
two characters, 5-10 

Delimiters, 3-2 

Direct assignment statements, 3-6 
.DSABL directive, 5-7 

.ENABL directive, 5-7 

* END directive, 5-17 
,ENDM directive, 6-2 
Error codes, D-l 

* ERROR and .PRINT directives, 6-10 
.EVEN directive, 5-15 

' t 

Expressions, 3-12 

Format control, 2-4 


•BLKB and „BLKW directives, 5-17 
Branch instruction addressing, 4- 
Branch instructions, conditional, 
.BYTE directive, 5-8 

Character set, 3-1 

illegal characters, 3-4 
MACll, A—1 

operator characters, 3-4 
RADIX-50, A-4 
Command input string, 7-1 
Comments within programs, 1-4 
field, 2-3 


Immediate conditional directives, 
5-21 

Immediate mode, 4-4 
glndefinate repeat block (.IRP and 

.IRPC) directives, 6-11 

Index deferred mode, 4-4 

Index mode, 4-4 

Label field, 2-2 

Listing control directives, 5-1 
Listing, MACll example, 5-4 
Loading MACll, 7-1 
Location counter, 5-15 
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MACRO calls , 6-3 
MACRO definition, 6-1 
arguments, 6-4 
formatting, 6-3 


MACRO 

directives, 

i—i 

i 

MACRO 

nesting, 6- 

4 

.MACRO 

directive. 

6-1 

.MEXIT 

directive, 

6-2 


Mode forms and codes, table, 4-6 
Modular programming, 1-1 


Registers 

increment, l-£ 
localized usage, 1-4 
register deferred mode, 4-2 
register mode, 4-2 
register symbols, 3-7 
Relative deferred mode, 4-5 
Relative mode, 4-5 

Repeat block (.REPT) directive, 6-14 


.NARG, .NCHR and .NTYPE directives 
6-9 

Number of MACRO arguments, 6-7 
Numbers, 3-11 

Numeric arguments passed as 
symbols, 6-6 

•ODD directive, 5-16 
Operand field, 2-3 
Operator field, 2-3 

Page ejection, 5-7 
Page headings, 5-5 
PAL-11R conditional assembly 
directives, 5-22 
Parameter assignments, 1-7 
Permanent symbol table, C-l 
.PRINT and .ERROR directives, 6-10 


oSBTTL directive, 5-5 
Source program format, 2-1 

Special characters, 6-5, B-l 

Statement format, 2-1 

direct assignment, 3-6 

Subconditional directives, 5-19 
Symbols 

MACH, 3-5 
local, 3-8 
permanent, 3-5 
register, 3-7 
user-defined & MACRO, 3-5 

Terminating directives, 5-17 
Terms, 3-11 
.TITLE directive, 5-5 
Trap handler, 1-7 

.WORD directive, 5-9 


.RAD50 directive, 5-12 
.RADIX control directive, 5-14 
temporary, 5-14 
Reentrant code, 1-6 
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HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products. Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi¬ 
cally. For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to: 

Software Communications 
p. o. Box F 

Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 

Questions or problems relating to Digital 1 s software should.be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 


Reading, England 
Paris, France 
The Hague, Holland 
Tel Aviv, Israel 


Milan, Italy 
Solna, Sweden 
Geneva, Switzerland 
Munich, West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 


Digital Equipment Corporation 
Software Distribution Center 

146 Main Street 

Maynard, Massachusetts 01754 


Digital Equipment Corporation 
Software Distribution Center 

1400 Terra Bella 

Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative• 


USERS SOCIETY 


DECUS, Digital Equipment Computer Users Society, maintains . a user ex- 
change center for user-written programs and technical application in¬ 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


DECUS EUROPE 

Digital Equipment Corporation 
International (Europe) 

P.O. Box 340 
1211 Geneva 26 
Switzerland 







MAC11 Programming Language 
(MACH) 

DEC~»15~LMCMA~A-D 


READER s S COMMENTS 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page). 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

□ Assembly language programmer 

I | Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 
I I Student programmer 

□ Non-programmer interested in computer concepts and capabilities 

Name_ . __ Date ______ 

Organization ______ 

Street. . ....... 

City--State_Zip Code_ 

or 

Country 

If you do not require a written reply, please check here. Q 
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